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PREFACE 


CAUTION 


This document provides detailed technical information 
revealing internal details of the HP 150 hardware, 
firmware, and software. 

The information presented allows development of hardware 
and software products for the HP 150 which may be 
incompatible with future personal computer products from 
Hewlett-Packard, including models based upon the HP 150 
itself. 


This manual presents technical information concerning the HP 150 Personal 
Computer and covers its hardware, firmware, and software subsystems. 

The intent of the manual is to aid in the development of hardware and software 
products which will become part of, or work in conjunction with, the HP 150. 

The reader is directed towards the HP 150 Programmer’s Reference materials for 
complementary programming information including language and development tools. 
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MANUAL OVERVIEW 


This manual consists of the following sections and appendices: 

Section 1 - Introduction provides an overview of the HP 150. 

Section 2 - Hardware Overview provides product specifications 
information and briefly describes each subsystem 
of the HP 150. 

Section 3 - Hardware Subsystems contain detailed information 
on the HP 150’s hardware subsystems auid helpful 
design hints. 

Section 4 - Memory and I/O Mapping provides information on the 

memory and input/output bit mappings of the system’s 
processor. 

Section 5 - System Software provides information on the 

operating systems, device drivers, MS-DOS calls, 

AGIOS, BIOS, configuration, and disc format structure. 

Section 6 - System Firmware provides mapping informaiton on 
system RAM memory. 

Section 7 - Programming the HP 150 contains programming 

information on escape sequences, MS-DOS, AGIOS, 
alphanumeric and graphics displays, datacomm, 
keyboard, HPIB, and accessory card interfacing. 

Section 8 - AGIOS Function Call Reference provides a 

reference list of AGIOS function calls. 

Appendix A - Logic Diagrams contain schematic diagrams of the HP 150. 

Appendix B - Further Reference Documents provides a list of 

reference documents to supplement this manual. 
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This section provides an overview of the HP 150’s system architecture, display, 
keyboard, data communications, and peripherals. 
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Introduction 


HP 150 SYSTEM OVERVIEW 


The HP 150 Personal Office Computer, the third member of the Series 100 family, 
offers a complete business solution and gives the customer more power and memory 
space in a small, efficient package. The entire sytem (display, processor, 
keyboard, flexible and Winchester disc drives, and integral printer) occupies 
only 2.1 square feet of space, about the same "footprint" as an open looseleaf 
notebook. Several features have been added to decrease the amount of time 
required to learn and use the system such as a touchscreen interface and an 
advanced "shell" called the Personal Applictions Manager 

(P.A.M.) which shields the user from the "computerese" associated with many 
computer systems. 

The HP 150 system features are summarized below. 


System Architecture 

- Intel 8088 microprocessor (operating at 8 MHz) 

- MS-DOS 2.0 operating system 

- Built-in HPTouch 

- 256K bytes of main memory standard; 640K bytes maximum 

- Battery back-up for system configuration and real time 
clock 

The HP 150 uses an Intel 8088 microprocessor running at 8 MHz. The standard 
system contains 256K bytes of RAM memory for the operating system, applications 
and user workspace, and cam be expamded to 6U0K. Touchscreen amd graphics are 
standard with the system. 

In addition to the above capabilities, the HP 150 is also a customer expandable 
system. There are two expamsion slots, accessible through the back of the unit, 
which allow the customer to add accessories (such as additional memory) to the 
system without requiring the assistance of an HP representative or dealer. 
Installation of accessories is a simple operation, requiring an average of 5 "to 
10 minutes . 

The HP 150 Personal Computer uses MS-DOS 2.0 from Microsoft Corporation as the 
standard operating system. MS-DOS 2.0 is a single-user, single-task operating 
system for which many third-party software packages have been developed. The 
operating system resides on disc amd upon initialization MS-DOS is loaded into 
the processor’s main memory. 
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Introduction 


A unique enhancement by Hewlett-Packard to the MS-DOS operating system has been 
the addition of an easy-to-understand facility to help the user execute 
commands. PAM (Personal Applications Manager) provides simple intuitive menus 
for the most frequently used system commands . Unlike other systems which 
require the user to learn the system "computerese", PAM through menus and 
HPTouch, guides the user through commands. With PAM starting applications, 
creating directories, deleting files and listing existing files can be as easy 
as touching the screen. For more advanced users the standard MS-DOS command 
facility is also available. 


Display 

- Built-in high-resolution on-screen graphics display 
(512 X 390) 

- High-resolution character display; 9 x 14 dot character 
cells; upper and lower case 

- Display enhancements: inverse video, underline, blinking, 
half -bright, security and all combinations 

- Up to two pages of 2k lines x 80 characters of display 
memory 

The HP 150 can display both alphanumeric and graphics on the 9 inch diagonal 
screen. The alphanumeric display consists of a 27 line by 80 column format. 
The 25th and 26th lines are used for the screen labeling of function keys (and 
all are automatically "touchable" through touchscreen) , and the 27th line is for 
system status and error messages. The screen memory stores 2 pages of text, 
which allows off-screen storage of the display. High resolution characters with 
true descenders are generated in a 9 x 14 dot cell with half -dot shift. The 
standard display is green character against a black background. 

The graphics display has a resolution of 512 dots horizontally by 390 dots 
vertically. This gives a 1:1 aspect ratio guaranteeing symmetry (that is, 
circles look like circles). The numeric keypad also serves as the graphics 
keypad, allowing the customer to turn on and off the alpha display, turn on and 
off the graphics display or transfer the graphics display to one of the HP 
graphics printers. It also displays the graphics cursor and allows it to be 
moved around the screen. 
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Keyboard 

- Detachable, typewriter-style 

- Special editing keys 

- Numeric/Graphics pad 

- Eight screen -labeled function keys 

The HP 150 keyboard is designed to provide a familiar interface to the system 
and minimize training time. The low-profile keyboard shape, the sculptured 
keycaps and the dished "home" keys help to make the keyboard comfortable to use. 
The 107-key keyboard contains the full local editing keys such as cursor control 
keys, display scrolling keys, "next" and "prev" keys for scrolling by pages and 
"insert" and "delete" keys for inserting or deleting characters or entire lines. 

Series 100 function keys are screen labels used by the system and by application 
programs to increase the ease of use of the system. With the HP 150, this 
capability is enhanced by the use of HPTouch. Now, all function keys can be 
selected by pressing the key itself or by touching the key label on the screen. 


Communications/Peripherals 

- One RS-232/RS-U22 communication port 

- One RS-232 communication port 

- One HP-IB port 

- Full block mode graphics terminal support 

Two RS-232-C ports (one of which is capable of RS-U22 communication) may be used 
to connect the system to a remote computer or to serial devices (such as 
printers or plotters). Flexible protocols allow the use of either hardware or 
software handshaking and communication speeds can range from 110 to 19,200 baud. 

The HP 150 contains the HP 2623 Graphics terminal feature set and can run any HP 
3000 software which currently runs on that terminal. This includes block mode 
for V/3000 software and graphics applications such as HPEasychart and HPDraw as 
well as line-drawing and math character sets, "security" fields, transmit-only 
fields, edit checks and Tektronix U010/U01U emulation. 
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Hardware Overview 


INTRODUCTION 


The HP 150 digital hardware performs the logic functions of a l6 bit personal 
computer with screen graphics. It consists of a Processor PCA, a Memory PCA, 
a Video subsystem PCA, a Touchscreen PCA, a Front Plane PCA, and a Keyboard PCA 
within the Keyboard itself. Its operation is based on the 8 MHz 8088 
microprocessor. 

The Processor PCA provides control signals, input/output and data processing 
functions. The ROM/RAM PCA provides 256K bytes of dynamic RAM for system and 
user memory and up to 160K bytes of ROM. The Video subsystem PCA controls the 
display RAM and provides video display data and timing signals for driving the 
sweep circuitry. The Touchscreen PCA provides an easy user interface to the 
system beyond the standard keyboard. Two accessory slots are provided allowing 
for memory expansion and additional processing and I/O capability. 


PRODUCT SPECIFICATIONS 


General Description 


System Processor: 


Main Memory: 

Screen Size: 
Alphanumeric 
Graphics 

Screen Capacity: 


Character Generation: 


Character Size: 
Character Set: 


Cursor: 


Intel 8088 microprocessor 
operating at 8 MHz 

256K bytes of RAM memory 

9 inch diagonal 

116 X 150 mm (4.5 X 5.9 inches) 

120 X 160 mm (4.7 X 6.3 inches) 

24 lines X 80 columns, 25th and 
°6th lines for labeling of 
function keys, 27th line for system 
status/error messages. 

7 X 10 enhanced dot matrix with 
1/2 dot shifting, 9 X 14 dot 
character cell, noninterlaced 
raster scan. 

1.3 X 2.8 mm (0.05 X 0.11 inches) 

Roman8, line drawing, math standard 
(also bold and italic usable by 
applications only) 

Blinking underline or blinking square 
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Display Enhancements: Inverse video, underline, blinking, 

half -bright, security, and all 
combinations . 

Refresh Rate: 60 Hz 

Tube Phosphor: P31 (green) 

Implosion Protection: Tension band 

Keyboard: Full ASCII code keyboard, eight 

screen-labeled function keys, 
auto-repeat, N-key rollover, cursor 
controls, 18 key numeric pad, 
detachable with 2.43 m (8 ft.) 
coiled cable. 


Physical Specifications 

System Processor Weight: 10.15 kg (22.34 lbs.) 

Keyboard Weight: 2.14 kg (4.71bs.) 

Display Monitor 305 nan (W) X 305 ram (D) X 287 ram (H) 

Dimensions: [12.0 in. X 12.0 in. X 11.3 in. ] 

Keyboard Dimensions: 

Flat 456 mm (W) X 225 ram (D) X 35 ram (H) 

[18.0 in. X 8.9 in. X 1.4 in. ] 


Standing 456 mm (W) X 225 mm (D) X 35 mm (H) 
[18.0 in. X 8.9 in. X 2.5 in. ] 


Environmental Conditions 

Temperature (Free Space Ambient): 


Non-operating 

Operating 

With 2674A (Integral 
Thermal Printer) 

Humidity: 

“ Vibration: 

“Shock 


-40 to +75 C (-40 to +167 F) 

0 to +50 C (+32 to +131 F) 

0 to +50 C (+32 to +131 F) 

5 to 95% noncondensing 
5-55 Hz § 0.015" displacement 
30g, 11 ms, 1/2 sine 
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*Type tested to qualify for normal shipping and handling 

original shipping carton. 

Product Regulations 

This product when used with HP approved options and peripherals meets the 
requirements of the following agencies /standards for EDP equipment or office 
equipment in the following countries: 

Safety: Canada - CSA Certification 

International - IEC 380/435 Compliance 
United States - U.L. Listing 
Finland - FEI (pending) 

RFI: Germany - VDE Class B 

United States - FCC Level B 

Datacomm: CCITT V. 24 interchange V. 28 electrical 

Australia - Telecom (pending) 

Belgium - PTT (pending) 

Finland - PTT (pending) 

Germany - FTZ (pending) 

Sweden - PTT (pending) 

U. K. - BT (pending) 


Power Requirements 


Input Voltage: 115 V (+10%, -25%) at 50/60 Hz (+-5%) 

230 V (+10%, -25%) at 50/60 Hz (+-5%) 

Power Consumption: 

45610A 240 Volt Amp 

45650A 356 Volt Amp 

456 5 5A 356 Volt Amp 

4566OA 356 Volt Amp 


Communications 


Data Channels: 1 HP-IB, 1 RS-232/RS-422 , 1 RS--232 

HP-IB Channel: Bus used only for specified HP peripherals 

RS-232 Channel: General asynchronous communications 

Data Rate (RS-232): 110, 150, 300, 600, 1200, 2400, 

4800, 9600, and 19200 baud 
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Port 1 and 2: 


Port 1, only: 


EIA standard RS-232-C and CCITT V.24; 
hardware and XON/XOFF handshaking 
available. 

RS-422 communication capability 


Subsystem Power Requirements 

The figures below are the worst case power consumption figures for the main 
system boards. The values given for accessory slots are obtained by subtracting 
the main system board power consumption figures from the power available from 
the power supply printed specifications. A more realistic set of figures for 
accessory hardware board designers to use in determining power available for 
accessories is given in Section 3* 


PCA 

+5 Volt 

+12 Volt 

-12 Volt 

Sweep Board: 

125 mA 

1.9 A 

60 mA 

Processor: 

2.3 A 

140 mA 

80 mA 

ROM/RAM: 

1.0 A 

0 

0 

Video subsystem: 

3-4 A 

0 

0 

Front plane: 

75 mA 

0 

0 

Thermal Printer: 

800 mA 

2.2 A * 

0 

Touch Screen: 

0 

150 mA 

20 mA 

Mezzanine DatacQmm: 

200 mA 

50 mA 

50 mA 

Accessory Slots: 

1.75 A 

280 mA 

270 mA 

TOTAL 

9.6 A 

2.5 A ** 

480 mA 


* This current at +12v for the TPM comes from a separate winding on the power 
supply . 

** This total does not include the current supplied for the TPM on the 
separate winding. 
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HP 150 PRINTED CIRCUIT ASSEMBLIES 


The HP 150, in its standard configuration consists of seven modules. They are 
the Processor, Video, Sweep/CRT, Touchscreen, Keyboard, Power Supply, and Front 
Plane. Below is a block diagram of the HP 150 system showing each of the 
modules and their associated PCAs. 


SWEEP PCA 


VIDEO PCA 


j SWEEP/CRT 

I 

I 


< + 


TOUCHSCREEN PCA 


| TOUCHSCREEN 

I 

I 


VIDEO 


/l\ 

FRONT | 
PLANE PCA | 

\l/ 


+— >| FRONT PLANE |< 
>1 |< 


I 

~ 7TV 

PROCESSOR | 
PCA j 

\l/ 


MEZZANINE 
MEMORY PCA 


PROCESSOR 


DATACOMM PCA | | 

/l\ /l\ /l\ 

I I I 


HP- IB + > 

DEVICES 


DISCS, 
PRINTERS, 
PLOTTERS, ETC. 
(OPTIONAL) 


| OPTIONAL | 

j THERMAL | 

+-->| PRINTER j 


POWER 

SUPPLY PCA 


--+ | POWER 

j SUPPLY 


KEYBOARD PCA 

l__ | 

> | KEYBOARD | 


SERIAL PORT 2 (RS-232 DEVICES) 

SERAI AL PORT 1 (RS-232/RS-422 
DEVICES) 


Figure 2-1. HP 150 Hock Diagram 


A brief description of each PCA in the HP 150 system is given below. Each 
board is described in detail in Section 3- 
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Analog Boards 


POWER SUPPLY PCA. The power supply used in the HP 150 system is a 120 watt 
switching supply that provides +5, +12, and -12 volts to the system 
components. The supply is mounted vertically to the side of the metal chassis 
and supplies power to the system through a cable which connects to the front 
plane board and a separate connector on the power supply connects to a ribbon 
cable to provide +12V to the optional thermal printer (TPM) . An overview of the 
supply is provided in Section 3- 


SWEEP PCA. The sweep electronics (assembly 45600-6000U) used for HP 150 is 
the same sweep used in the HP 120 computer system. This board also mounts 
vertically to the side of the metal chassis and interfaces to the digital 
logic on the video board via a ribbon cable to the front plane board. This 
sweep provides focus, brightness, vertical and horizontal centering controls 
at the rear of the unit. Coarse brightness, horizontal width and 
vertical size controls are accessible after removal of the shroud of the system. 
Details about this board as well as the yoke and CRT are found in Section 3. 


Digital Logic Boards 


There are six PC As containing primarily digital logic which create the HP 
150 hardware personality. 

PROCESSOR PCA. The processor board (U56II -60002) houses the 8088 
microprocessor, the heart of the system. The bulk of the 1/0 components such 
as HP-IB controller, keyboard and touchscreen controller, real-time clock, and 
datacomm are on this board. The processor board interfaces to the rest of 
the system boards through 96 pin, 60 pin, and 30 pin connectors. The processor 
board connects to the front plane through the 96 pin connector. The 60 and 30 
pin connectors are physically mounted on top of the processor board, and connect 
the mezzaifine memory and datacomm PCAs, respectively. See Section 3 for a 
discussion on the processor board. 
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KEYBOARD PCA. The keyboard is detached from the HP 150 unit and a cable 
connects it to a 6 pin phone jack on the processor board. See Section 3 for 
more keyboard information. 


MEZZANINE MEMORY PCA. The mezzanine memory board (U56II-60006) is one of 
two boards mounted on the processor board in a mezzanine position beneath 
the video board. The memory board contains ROM, dynamic RAM, CMOS RAM, 
and indicator LEDs. A 60 pin connector is used to interface the memory and 
processor boards. See Section 3 for detailed memory board information. 

RS232C/422 DATACOMM PCA. The RS232C/422 board (45611-60015) is the other 
board in a mezzanine position. It connects to the processor board through a 
30 pin connector. The board has provision for both asynchronous and 
synchronous communications and can meet RS232C or RS422 communications 
standards. Details on this board are in Section 3* 


FRONT PLANE PCA. The front plane board (U 56 II- 6 OOO 5 ) provides the interconnect 
for the processor, video, touchscreen, sweep, TPM, and accessory boards. 
The front plane also serves as a conduit for power to the various PCAs from 
the power supply. Section 3 describes the front plane in more detail. 


VIDEO PCA. The alphanumeric and graphics displays are generated by the video 
subsystem, the core of which is the video board (45611-60003) . The video 
board design is based on an SMC9007 display controller and a custom 40 pin 
gate array for generation of the alpha and graphics displays respectively. 
This board is covered in Section 3. 


TOUCHSCREEN PCA. The touchscreen board (45611-60001) is actually a 
mixture of analog and digital circuitry. The 8088 interfaces to the 
touchscreen via the 8041A keyboard/touchscreen controller. A 10 conductor 
ribbon cable connects the touchscreen to the front plane where information is 
in turn exchanged with the processor board. Details on the touchscreen are in 
Section 3« 
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SECTION 


This section provides detailed information on the hardware subsystems of the HP 
150. Design hints on the optional accessory card are discussed here also. 
Subsystem discussion includes the front plane, processor, video, keyboard, 
touchscreen, datacomm, and memory. 
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FRONT PLANE 


The front plane, or mother board, of the HP 150 system is the board that 
provides the interconnection of the various components of the system. The 
processor, video, and two optional accessory boards plug into connectors on the 
front plane. Four cable connectors interface the power supply, sweep, 
touchscreen, and optional TPM to the rest of the system via the front plane. 

The front plane is used primarily to provide a communications path from the 
processor board to the video and accessory boards. Th^re is some digital logic 
on the front plane which is used for transferring bytes from the processor to 
the TPM. This circuitry is described below. Power for each of the boards comes 
from the power suppply via the front plane. Video signals are transmitted to 
the sweep via the front plane and timing signals for the touchscreen are 
transmitted or received via the front plane. 

Thermal (Integral) Printer Interface 

The optional thermal printer mechanism (TPM) interfaces to the rest of the 
system via logic on the front plane and processor boards. The processor sends a 
data byte to the TPM by writing the byte into a transparent latch on the 
front plane. A negative going pulse on NTPMWRT is sent causing the latch to 
receive the data byte. On the positive edge of NTPMWRT (the deassertion of 
NTPMWRT) the byte is latched into the latch. Also, a D flip-flop on the front 
plane is clocked which results in NSTR (JET-15) being asserted (goes low). The 
assertion of NSTR tells the TPM that a byte is available for it to read. After 
the TPM reads the byte in the latch, it asserts NACK (JF7~6) by bringing it low. 
This results in the flip-flop preset inputs going low presetting the two D 
flip-flops. This makes NSTR go back high in preparation for the next byte to be 
sent to the TPM by the processor. It also makes the output of the D flip-flop 
go low which in turn makes NOCINT go low. NOCINT is one of the open collector 
interrupt lines on the front plane. Asserting NOCINT causes an interrupt to the 
processor. The interrupt service routine will poll the devices which assert 
NOCINT to determine which device to service. After receiving an interrupt from 
the TPM* interface logic, the 8088 cam send smother byte to the TPM. (Note that 
an interrupt service routine must poll the TPM interface logic last because the 
poll consists of reading the TPM status which also clears the interrupt at the 
end of the poll.) 

The TPM status can be determined by reading the status register. The NTPMRD 
signal is asserted (goes low) by the processor board which enables the bus 
driver on the front plane to drive the data bus. Bit 0=1 if acknowledge has 
been sent by the TEW in response to a byte sent to the TEW. Bit 1=1 if the TPM 
is installed and bit 2=1 if paper is present in the TPM. (Bits 3 _ 7 are not 
used.) The deassertion of NTPMRD (its rising edge) clocks the flip-flop which 
clears the interrupt generated on NOCINT. 
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A read or write to the TPM will cause the processor board signal NTPMSL to go 
low which results in 6 wait states to be added to the bus cycle. 

The TPM connects via a ribbon cable to a connector on the front plane. The 8088 
accesses the TPM at I/O address XX30 as described in the Memory and I/O Mapping 
section of this manual. Note that "XX" can be any (address) value. 

Summarizing, a byte of data is sent to the TPM by writing the data at port XX30. 
The TPM acknowledges the receipt of the data and readiness to accept the next 
byte of data to be sent by asserting the NOCINT interrupt line. The interrupt 
handling routine can poll the TPM by reading port XX30 and inspecting the least 
significant bit. If the bit is set, the TPM has generated an interrupt. The 
end of the read cycle clears the interrupt if caused by the TPM. PAPER OUT and 
ONLINE status are also available at the same address. 


Front Plane Connectors and Signals 

The following paragraphs provide a description of the connectors and the 
connector signals on the front plane . 

Front Plane PCA Connector Layout: 


| JF1 - VIDEO BOARD 


JF8 - 
POWER 


JF5 - 

1 1 


SWEEP 


JF7 

JF6 - 


INTEGRAL 

| TOUCHSCREEN 

1 1 1 

1 1 1 


PRINTER 

r 

1 

1 1 1 
1 1 1 
1 1 1 
1 

| JF2 - PROCESSOR BOARD | 
1 1 

I 

1 

1 

1 


| JF3 - ACCESSORY SL0T1 | | JFU - ACCESSORY SL0T2 | 
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JF2 - Processor Board Front Plane Connector Pinouts and Signals 


1. FPA 0 

2. FPA 1 

3. FPA 2 

4. FPA 3 

5. FPA 4 

6. FPA 5 

7. FPA 6 

8. FPA 7 

9. ABUS 8 

10. ABUS 9 

11. ABUS 10 

12. ABUS 11 

13. FPA 12 

14. FPA 13 

15. FPA 14 

16. FPA 15 

17. FPA 16 

18. FPA 17 

19. FPA 18 

20 . FPA 19 

21. FPD 0 

22. FPD 1 

23- FPD 2 

24. FPD 3 

25. FPD 4 

26. FPD 5 

27. FPD 6 

28. FPD 7 

29. FPNSSO 

30. NSLOTSEL1 

31. BATV 

32. BATV 


32 | + + ... 

64 | + + 

96 | + + . . . 


33. NTPMWRT 

34. NPFAIL 

35. NSLOTSEL 2 

36. FPNRST 

37. NOCINT 

38. NOCWAIT 

39. +5V 

40. BIO/-M 

41. -12V 

42 . NVIDINT 

43. -12V 

44. FPGO 

45. GND 

46. GND 

47. FPCLK 

48. GND 

49. GND 

50. BIO/-M 

51. +12V 

52. FPDT/-R 

53. +12V 

54. SHOLDA 

55. FPNWRT 

56 . N.C. 

57. FPNRD 

58 . +5V 

59. N.C. 

60. GND 

61 . TSCLK 

62. GND 

63 . N.C. 

64. FULLMEM 

JF2 


65 . NTPMRD 

66. GND 

67 . GND 

68. +5V 

69 . GND 

70. +5V 

71. GND 

72. GND 
73- GND 

74. GND 

75. GND 

76. GND 

77. GND 

78. GND 

79. GND 

80. GND 

81. GND 

82. GND 

83. GND 

84. GND 

85 . GND 

86. GND 

87. GND 

88. +5V 

89 . +5V 

90 . + 5 V 

91. +5V 

92. TSDATA 

93. GND 

94. NDCOCINT 

95. TSSYNC 

96 . + 5 V 


. . . + + | 1 
• • . + + I 33 

. . . + + | 65 


Pictorial view of processor board front plane connector with pin 
assignment (as viewed from component side of front plane board) 
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Video Board Front Plane Connector 


JFl - Video Front Plane Connector Pinouts and Signals 


1 . 

FPA 0 

36. 

+5V 

2. 

FPA 1 

37. 

GND 

3. 

FPA 2 

38. 

FPNRST 

4. 

FPA 3 

39- 

GND 

5- 

FPA 4 

4o. 

NOCWAIT 

6. 

FPA 5 

4i. 

+5V 

7. 

FPA 6 

42. 

BI0/-M 

8. 

FPA 7 

43. 

GND 

9. 

ABUS 8 

44. 

NVIDINT 

10. 

ABUS 9 

45. 

GND 

11. 

ABUS 10 

46. 

FPGO 

12. 

ABUS 11 

47. 

GND 

13. 

FPA 12 

48. 

FPCLK 

14. 

FPA 13 

49- 

GND 

15. 

FPA 14 

50. 

+5V 

16 . 

FPA 15 

51. 

GND 

17. 

FPA 16 

52. 

BI0/-M 

18. 

FPA 17 

53. 

GND 

19. 

FPA 18 

54. 

FPDT/-R 

20. 

FPA 19 

55. 

N.C. 

21. 

FPD 0 

56. 

+5V 

22. 

FPD 1 

57. 

N.C. 

23. 

FPD 2 

58. 

FPNRD 

24. 

FPD 3 

59- 

GND 

25- 

FPD 4 

60 . 

(RESERVED) 

26 . 

FPD 5 

6l. 

GND 

27. 

FPD 6 

62 . 

+5V 

28. 

FPD 7 

63- 

GND 

29- 

+5V 

64. 

NVSYNC 

30. 

+5V 

65- 

GND 

31. 

+12V 

66. 

NHSYNC 

32. 

+12V 

67. 

GND 

33. 

+12V 

68. 

NHB 

34. 

BATV 

69- 

NFB 

35- 

BATV 

70. 

GND 


JFl 

+ + . . . 


. • . + 

+ + . * . 


... + 


Pictorial view of processor board front plane connector with pin 
assignment (as viewed from component side of front plane board) 
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Accessory Front Plane Connectors 

The accessory boards plug into the bottom slots of the card cage. The 
signals available to the modules are listed below. 

JF3/1+ Accessory Board Front Plane Connector Pinout and Signals 


1 . 

FPA 0 

36. 

(RESERVED) * 

2. 

FPA 1 

37. 

NPFAIL 

3. 

FPA 2 

38. 

(RESERVED) * 

4. 

FPA 3 

39. 

FPNRST 

5- 

FPA 4 

4o. 

+5V 

6. 

FPA 5 

4l. 

GND 

7. 

FPA 6 

42. 

GND 

8. 

FPA 7 

43. 

NOCINT 

9. 

ABUS 8 

44. 

GND 

10. 

ABUS 9 

45. 

NOCWAIT 

11. 

ABUS 10 

46. 

(RESERVED) * 

12. 

ABUS 11 

47. 

BI0/-M 

13. 

FPA 12 

48. 

+5V 

14. 

FPA 13 

49- 

-12V 

15- 

FPA 14 

50. 

NDCOCINT 

16. 

FPA 15 

51- 

GND 

17. 

FPA 16 

52. 

-12V 

18. 

FPA 17 

53. 

SHOLDA 

19- 

FPA 18 

54. 

FPGO 

20. 

FPA 19 

55- 

+5V 

21. 

GND 

56. 

GND 

22. 

GND 

57. 

FPCLK 

23. 

FPD 0 

58. 

(RESERVED) * 

24. 

FPD 1 

59. 

GND / FULLMEM 

25- 

FPD 2 

6o. 

+12V 

26. 

FPD 3 

6l. 

GND 

27. 

FPD 4 

62. 

BI0/-M 

28. 

FPD 5 

63. 

+12V 

29- 

FPD 6 

64. 

FPNWRT 

30. 

FPD 7 

65. 

+5V 

31. 

GND 

66. 

FPDT/-R 

32. 

FPNRD 

67. 

GND 

33. 

GND 

68. 

FPNSSO 

34. 

+5V 

69. 

GND 

35- 

BATV 

70. 

NSLOTSELx ** 


JF3 and JFU 

+ ~ . 

35 I + ♦ . . . 

70 | + + . . . 

+ ~ - — 


+ + | 1 
+ + I 36 


Pictorial view of option module front plane connector with pin 
assignment (as viewed from component side of front plane board) 


system 
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* Pin 59 is FULLMEM is on JF3 only. Pin 59 is GND on JF4. 

Connections to this pin and all pins labeled RESERVED should not be made. 

** NSLOTSELx will be either NSL0TSEL1 or NSL0TSEL2 depending upon which 
side of the front plane the module is plugged into. The left side of 
the card cage (from rear view of the package) holds module 1 and gets the 
NSL0TSEL1 signal. The right side of the card cage holds module 2 
and gets NSL0TSEL2 . 


Sweep Board Connector 

The Sweep board connects to the front plane via a 20 pin connector, 
JF5, whose signal pins are listed below: 


+ + 


20. | 

+ 

4- 

1 

10. 

20. 

+5V 

10. 

NHSYNC 

1 

+ 

4- 

1 


19. 

GND 

9. 

+12V 

1 

+ 

4* 

1 


18. 

NHB 

8. 

GND 

1 

+ 

4* 

1 


17. 

GND 

7. 

+12V 

1 

+ 

4- 

1 


16 . 

NFB 

6. 

GND 

1 

+ 

4- 

1 


15. 

GND 

5- 

+12V 

1 

+ 

4- 

1 


14. 

SWPNRST 

4. 

GND 

1 

+ 

+ 

1 


13. 

-12V 

3. 

GND 

1 

+ 

+ 

1 


12. 

+12V 

2. 

+12V 

11. | 

4- 

+ 

1 

i. 

11. 

NVSYNC 

1. 

+5V 


+ + 


JF5 


Touchscreen Connector 

The Touchscreen connects to the front plane via a 10 pin connector, JF6, whose 
signal pins are listed below: 


4- 4- 


1. 

1 

+ 

4* 

1 

6. 

l. 

+12V 

6. 

-S-12V 


1 

4 - 

*r 

1 


2. 

TSDATA 

7. 

+12V 


1 

4 - 

4- 

1 


3. 

-12V 

8. 

GND 


1 

4 * 

-r 

1 


4. 

TSSYNC 

9- 

TSCLK 

5. 

1 

4 - 

4 - 

1 

10. 

5- 

GND 

10. 

GND 


-f 4- 

JF6 
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Integral Printer Connector 

The Integral Printer connects to the front plane via a 20 pin connector, 
JF7, whose signal pins are listed below. 


+ + 


1. 1 

4 

4 

1 

li. 

1 . 

DO 

11. 

D1 

1 

4 

4 

1 


2. 

D2 

12. 

D3 

1 

4 

4 

1 


3- 

D4 

13- 

D5 

1 

4 

4 

1 


4. 

D6 

14. 

D7 

1 

4* 

4 

1 


5- 

NPOR 

15. 

NSTR 

1 

4 

4 

1 


6. 

NACK 

16 . 

POUT 

1 

4 

4 

1 


7. 

N.C. 

17. 

NONL 

1 

4 

4 

1 


8. 

GND 

18. 

GND 

1 

4 

4 

1 


9. 

+5V 

19- 

+5V 

10. 1 

4 - 

4- 

1 

20. 

10. 

N.C. 

20. 

N.C. 


+ + 


JF7 


Power Supply Connector 

Power to the system comes from the power supply through a 12 pin connector, 
JF8, on the front plane board. The signal definition is given below: 


4 + 


1. 

1 

4- 

1 

NPFAIL 


1 


1 

(Pin removed for polarization) 

3. 

1 

4 

1 

GND 

4. 

1 

4- 

1 

-12V 

5- 

1 

4 - 

1 

GND 

6. 

1 

4 - 

1 

(N.C.) 

7. 

1 

4 

1 

+12V 

8. 

1 

+ 

1 

GND 

9- 

1 

4 

1 

45 V 

10. 

1 

4 * 

1 

45 V 

11. 

1 

4 

1 

45 V 

12. 

1 

4 

1 

GND 


4 - - 


-4 




JF8 




Front Plane Signal Descriptions 

The following description of the front plane signals reference the connector 
diagrams shown previously. 


FPA 0-7 


The lower 8 address bits of the 20 bit address generated by 
the 8088. These signals are buffered and demultiplexed. 


ABUS 8-11 The upper 12 address bits of the 20 bit address. 
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FPA 12-19 
FPDBUS 0-7 

FPCLK 

FPNRD 

FPNWRT 

FPNSSO 

BIO/-M 

FPDT/-R 

FPGO 


NOCWAIT 


NVIDINT 


NDCOCINT 


NOCINT 


These signals also are buffered and demultiplexed. 

Data bus signals from the external data bus. This data 
path is the means through which data is passed between the 
processor and the video board or option slot modules or the 
optional TPM. 

Buffered 8 Mhz system clock. 

Buffered -RD signal from the 8088 used to indicate a bus 
read cycle in progress. 

Buffered -WRT signal from the 8088 used to indicate a bus 
write cycle in progress. 

8088 bus cycle status line. The combination of FPNSSO, 
BI0/-M, and FPDT/-R allow boards connected to the front plane to 
completely decode the current bus cycle. 

Buffered I0/-M signal from the 8088 used to distinguish 
memory and I/O bus cycles. 

Buffered DT/-R signal from the 8088 used to indicate 
direction of data from the 8088 for a given bus cycle. 

Signal which qualifies the address generated by the 
microprocessor. The address qualification is needed primarily 
for dynamic RAM circuits which cannot tolerate an assertion of 
RAS or CAS on a false address. FPGO goes high at the 
beginning of T2 and goes back low at the beginning of T4 of a 
bus cycle. FPGO cam also be used to terminate a bus write 
cycle by having its falling edge used to clock data into a 
register or other device on an accessory device in an option 
slot. Terminating the writes in this way can provide better 
hold timing than using FPNWRT. 

This line cam be asserted by the option modules or video 
board through am open collector gate to insert wait states into 
a bus cycle to provide sufficient time for a bus cycle access. 

This line is asserted by the video subsystem to generate an 
interrupt to the processor. This interrupt occurs once every 
frame. The signal can be monitored by the option slot 
devices if desired. 

This open collector interrupt signal has the saune interrupt 
priority as the datacomm controller chip on the processor 
board as it shares the same input to the interrupt controller as 
the datacomm controller chip does. This input can be asserted 
by accessories for interrupt servicing. 

System interrupt signal asserted by a device via an open 
collector gate. This line can be used by options slots to get 
processor service. 
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SHOLDA 

FULLMEM 

NSLOTSEL1 

NSLOTSEL2 

NFB 

NHB 

NHSYNC 

NVSYNC 

TSCLK 

TSDATA 

TSSYNC 

NTPMRD 

NTPMWRT 

FPNRST 

NPFAIL 

BATV 


Synchronized hold acknowledge signal from the 8088. HOLD 
is asserted by the mezzanine memory board. 

Indicates which mezzanine memory board option is installed. 
FULLMEM=0 if 128K RAM and FULLMEM=1 (it is pulled high by a 
pull up resistor on an installed extension memory board) if 
256 K RAM is on the board. An accessory should not connect to 
this signal pin. 

Signal indicating an address within the 64K block allocated to 
option module 1 has been generated by the 8088. 

Same as NSL0TSEL1 but asserted when address within option module 
2 address space is generated. 

Video Full-Bright signal to sweep board. 

Video Half-Bright signal to sweep board. 

Horizontal sync signal from video board used by the processor 
and sweep boards . 

Vertical sync signal from video to sweep board. 

Touchscreen clock signal. 

Touchscreen data signal. 

Touchscreen sync signal. 

Signal from CPU to read TPM status. 

Signal generated by the processor card to handshake bytes of 
data to the TPM. 


Signal generated by processor board at power-on time to 
initialize logic circuitry. 

Signal generated by the power supply indicating power supply 
output level stability. 


These two connector lines carry current from the batteries 
located on the video board to circuitry requiring battery 
back-up power such as the CMOS RAM and the CMOS real time 
clock. 
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PROCESSOR SUBSYSTEM 


Overview 

The HP 150 processor board is based on the Intel 8088-2 microprocessor. The 
microprocessor runs at an 8 MHz clock speed and is configured for operation in 
the minimum mode. The general architecture of the processor, memory, and I/O 
is depicted in figure 3~1* As shown in the diagram, the majority of the 
circuitry is partitioned between three data busses: the memory data bus, the 
I/O data bus, and the external data bus. 


+ 


Memory Data Bus 

+ >1 



+ 


Memory Board 

ROM 

Dynamic RAM 
CMOS RAM 


MEMORY BOARD 


PROCESSOR - I/O BOARD 


External Data Bus 


(to Front plane: 
Video, TPM and 
Option Modules) 


I/O Data Bus 


Keyboard /Touchs creen 
HP- IB 

Baud Rate Generator 
Datacomm Protocol Chip 
Datacomm Module Option 
Real Time Clock 
Interrupt Controller 


Figure 3~1 . Processor Board and Memory Board Block Diagram 
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Memory and I/O Mappings 

The logic on the processor board and the other boards which exchange data 
with the microprocessor are mapped into the 8088’s memory or I/O space. 
Section U depicts the memory and I/O maps for the system. Note that I/O 
addresses XX80 through XXFF are available for option module use. Also note 
that "XX" can be any value. 

Processor Board Block Diagram 

Besides the 8088 microprocessor, the processor board contains a number of LSI 
and MSI components which are used to interface with other subsystems, provide 
communications with external devices, or perform specialized functions. The 
block diagram in figure 3“2 shows the basic architecture of the board. This 
section of the manual will detail the various subsections and components of the 
processor board. 
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+- 

ABUS | 

8-11 j 


| Address | 

| Buffer | 
+ + 


ABUS 0-7 


-+ > Mezzanine 

| ABUS 0-19 Memory 


| ABUS 12-19 I 

+ + + + 

| Address | | Address | 

j Latch j j Latch j 

+ + + + 


Address 


A8-11 | 



AD 0-7 


AD 0-7 A12-19 


Address/Data | AD 0-7 Mezzanine 

— + > Memory 

Multiplexed Bus Data 


<< >>| FPD 0-7 Front 

< > plane 

<< >>| Data 


-+ + 

| AD 0-7 A12-19 | 

+ + + + 

| Address j | Address | 

I Latch j j Latch j 

+ + + + 

| FPA 0-7 I FPA 0-7,12-19 Front 

j FPA 12-19 I ABUS 8-11 Plane 

+ + > Address 

+ + 


<< >> 


+ ~ + 

MM58167 
Real 
Time 
Clock 


<< >> 


+ + 

8116T 

Baud 

Rate 

Generator 


+ + + + 

| I/O Data Bus | 

+ + + > 


->l 
I 
I 
I 

+ + I 

+ + 

| 80Ll | 

| Keyboard/Touchscreen | 

| Controller | 

+ + I I I I I I 

Keyboard< | | >Touchscreen Interrupt Inputs 



7201 


Datacomm 


< > 

Port 1 


< > 

Port 2 


+ + 

991 ^ 


HPIB 


< > 

Control 


< > 

Data 


Figure 3 _ 2. Processor Board Block Diagram 
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Reset, CMOS Power, and Test Strap Logic 

This set of miscellaneous circuits provide functions of an ancillary or 
support nature to the more visible functions of the board to be described 
later . 


RESET LOGIC The power-fail signal from the power supply (NPFAIL, Jl-3^) is 
used by the system as a power-on-reset and a CMOS device standby operation mode 
switch. NPFAIL is low when power is first applied to the system and goes high 
no sooner than 75 msec after the power supply output voltages have 
stablized at their specified values. When NPFAIL goes low due to the power 
being disconnected from the power supply, it does so at least 500 usee before 
the power supply output voltages go out of regulation. 


CMOS POWER CIRCUIT The CMOS power circuit regulates current use by real time 
clock and configuration CMOS memory between the batteries and the power supply 
while the unit is switched on. 


TEST STRAP LOGIC. If the test strap input is held low during execution of 
manufacturing self -test, a failing test will be iterated until the failure 
ceases or the input is brought high. This is intended to be a convenience for 
servicing purposes. 


Microprocessor System Architecture 

The system microprocessor is an 8088. The clock frequency the 8088 is run at 
is 8 Mhz. The 8088 is configured in the "minimum mode." As it is not the 
intent of this document to review microprocessor basics, please refer to the 
Intel 8088 data sheets and application notes for fundamentals on 8088 operation. 
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BUS CYCLES 


Address Generation. At the beginning of a bus cycle (memory or I/O access), the 
8088 places the memory or I/O address on its address and address/data pins. 
The address is multiplexed with the data and some of the status information 
so the processor board uses transparent latches to latch and buffer the 
address generated at the beginning of the cycle. Address bits A8--A11 are 
not multiplexed so a non-latching buffer is used for buffering those four 
signals. ALE (U211 pin 25) is the signal used to latch the address into the 
latches . 


Data Transactions. The 8088 does all data transactions through one of three bus 
tranceivers. All the mezzanine memory board components are isolated by a 
transceiver located on the memory board. All the I/O devices (real time clock, 
datacomm, baud rate generator, keyboard/touchscreen controller, HP-IB 
controller, etc.) are on the I/O bus which is separated from the 8088 by 
another transceiver on the processor board. Any access not to the mezzanine 
memory or the I/O bus will default to the front plane . 


Status Generation. The 8088 generates status information indicating the type of 
bus cycle in progress. Control signals based upon these are generated by the 
processor and are buffered and sent throughout the system to allow circuitry to 
respond properly to read, write, memory, or I/O cycles. 


HOLD State. The 8088 will be put into a HOLD state by the mezzanine memory 
approximately every 5 6 usee during dynamic RAM refresh. 


System Timing and Control Logic 

CLOCK GENERATOR. The 8284 a clock generator is used to provide the system 
clock for the HP 150 hardware. A 24 Mhz crystal provides the reference 
frequency used by the 8284. The 8284 creates an 8 MHz clock which nominally is 
high 33% and low 66 % of the 125 nsec period. The 8284 also divides the 8 Mhz 
clock by 2 to form the 4 Mhz signal used as the system clock for the 7201 
datacomm controller, the 8ll6T baud rate generator, the 9914A HP-IB controller, 
and the 8o4lA keyboard and touchscreen controller. 

The 8284 also provides a reset output pin which is used as a basis for the 
reset signals throughout the system hardware. 

The -F/C input (pin 13) of the 8284 is at a logic 0 state which selects the 
crystal oscillator as the source frequency for the 8284. 

The 8284 is a part of the wait state insertion logic. The 8284 is configured 
in the synchronous mode which affects some of the timing constraints the wait 
state generator logic has. Wail state generation is described in the next 
section. 
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WAIT STATE GENERATION. The basic bus cycle for the 8088 consists of four 125 
nsec clock periods during which the memory of I/O address is generated by the 
CPU followed by a transmission of data to or the reception of data from a 
memory or I/O device. The cycle can be extended by adding "wait states" to 
the basic 4 clock cycle. The standard bus cycle is shown in figure 3~3- 


CLK 

(8 Mhz) 


|<__ T1 T2 T3 — >|«~ T4 --- 


I I 


I I 


I I 


ALE 


READY 


\/ \/ 

/ \ 


Figure 3 _ 3- Standard Bus Cycle with no Wait States 


The four clock periods are labeled T1 through T4 for reference purposes. 
The 8088 samples the READY input during the low clock period of T3. If it is 
high at that time, no extra wait states are added. If it is low, a wait 
state is added as shown in figure 3-4. READY is sampled during the low 
clock period of every wait state. Whenever it is sampled high, the wait 
state is exited and the bus cycle goes into the T4 state. 


-- T2 T3 - — >|<— TW — >|<— TW t4 --->| 

CLK i | | | | \~\ | | 

(8 Mhz) | | | | | | | | I 


\ / \/ 

READY _/\__ / \ 

Figure 3”4. Bus Cycle with Two Wait States 


The READY input to the 8088 is driven by the RDY output (pin 5) of the 8284. 
The 8284 has two inputs, RDY1 and RDY2 (pins 4 and 6), by which wait states are 
controlled. Normally, wait states are added by RDY1 (NWAIT) . RDY1 is sampled 
at the falling edge of each clock, so effectively, the READY input of the 
8088 is controlled by what the 8284 samples at its RDY1 input just prior to 
the beginning of T3 or just prior to the beginning of each wait state. 

Some processor board logic exists to add a specific number of wait states to 
certain bus cycles. Two wait states are added to the bus cycle when the 88l4 
or 8041 or 8ll6 are accessed by the 8088 and 9 wait states are added when the 
real-time clock is accessed. 
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A minimum of one wait state is added to every bus cycle when jumper W1 is 
installed. (Access of devices requiring more wait states get the additional 
wait states needed but one wait state appears in bus cycles on accesses of 
devices whose decoding logic isn’t tied into the wait state generator.) 
Installing W2 causes no wait states to be added for ROM access only. 

Wait states may be inserted by other logic boards by asserting the NOCWAIT 
line that is routed to the front plane option slots and video board connector. 
As long as NOCWAIT is low, wait states will be executed by the 8088. Since 
the NOCWAIT input goes into a synchronizing flip-flop the wait states added 
by an option or the video board must be anticipated in a timely fashion. 
The timing diagram in figure 3 _ 5 illustrates wait state insertion and deletion 
by an option card. 


| < T2 -->| <-- T3 > 

| CLK | | I 


<-- TW > | <-- TW > | <-- T4 >| 

(auto) (added) 




\ 

NOCWAIT \ 


/ 

_/ 

Figure 3~5- Option Wait State Insertion 


To put in an additional wait state (there is one automatic wait state for 
all over the front plane bus cycles) the option must assert NOCWAIT no later 
than 2 clocks prior to the time the wait state is desired. Wait states are 
exited 2 clocks after the next falling edge of CLK from the point where NOCWAIT 
is deasserted. If an option is designed whose enable is qualified by FPGO 
(described in the next section) wishes to put in a wait state, it must assert 
NOCWAIT within: Tclk - Tfpgo - Tsu?4 - 2Tpfp = 125“ 38-3-20 = 64 nsec of the 
falling edge or beginning of T3- (Tclk = clock period, 125 nsec; Tfpgo = 
front plane GO delay; Tsu74 = 74S74 data setup time, Tpfp = front plane 
propagation delay.) 


GO GENERATOR. The purpose of the GO generator is to provide a signal to 
qualify the address generated by the 8088 on its address pins. The GO 
generator indicates the beginning of T2, end of T1 within a bus cycle and the 
beginning of T4. The address qualification is needed primarily for dynamic 
RAM circuits which cannot tolerate am assertion of RAS or CAS on a false 
address. Another feature of the GO signal is that its deassertion is useful 
for providing better hold margin timing on bus write cycles. A state machine 
is used to implement the GO generator. Basically, the machine inspects the 
NWAIT signal and ALELCH . When ALELCH goes high, the GO generator brings GO 
high at the next negative edge of the clock (beginning of T2). NWAIT is 
monitored until NWAIT goes high. Two clocks later, GO is brought low (at the 
beginning of T4) indicating the end of the bus cycle. 
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The machine algorithm is: 


i 

i 


/ \ 

/ \ 0 

/ ALELCH? \--- 

\ / 

\ / 

\ _/ 

I 1 


~ + 

I 


GO 


/ \ 

/ \ 

/ NWAIT? \ _ 
\ / 0 
\ / 

\ / 

I 1 


GO 


(TI, Tl, TU) 


(T2) 


(T3, TW) 


Figure 3 _ 6- GO State Machine Algorithm 

The HP 150 utilizes an 8284 clock generator (READY generator) operating in 
synchronous mode. Therfore, the RDY1 input of the 8284 (pin 4) must be 
stable 35 nsec before each falling edge of the clock. The GO generator 
circuit requires NWAIT to be stable 20 nsec prior to the falling edge. Thus, 
meeting the 8284 specification meets the GO generator NWAIT timing requirement. 


3-17 



Hardware Subsystems 


The timing relationship between GO and the other system timing is portrayed in 
figures 3 _ 7 and 3~8. 


|<__ ti T2 — >|<— T3 — >|<— T4 --->| 

CLK | | | | | | | | | 

(8 Mhz) | | | | | | | | | 


GO 


I 


Figure 3 - 7. Standard Bus Cycle with no Wait States 
with GO Timing. 


|< Tl — > | <-- T2 

I CLK | | 




TW > | <-- T4 >| 


ALE | | 


GO 


I 


Figure 3 '8. Bus Cycle with One Wait State 
With GO Timing. 

The skew between GO and the falling edge of the clock should not exceed 20 
nsec. 


Interrupt Controller 

The 8088 is capable of processing two types of hardware interrupts. 
One type is the non-maskable interrupt (NMI) which is processed when the NMI 
input to the 8088 makes a low to high transisti on. This occurs when a hard 
reset key sequence (CTRL -SHIFT-RESET) is issued by the user. The 8088, 
after getting an NMI, will use the values in memory locations 8,9>A,B for 
new code segment and instruction pointer values. This will cause the 8088 
to vector to an interrupt service routine. 
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The other type of interrupt processed by the 8088 is standard or maskable 
interrupts. This type of interrupt is invoked by the INTR input of the 8088 
going high. In response the 8088 will lower the NINTA or interrupt 
acknowledge output twice. The second time NINTA goes low, the 8259A 
interrupt controller will place an 8 bit vector on the data bus. This vector 
will be a value from 0 - QFFH. The 8088 will start at the memory location 
equal to 4 times the vector and load the content of that location and the next 
three locations into the instruction pointer and code segment 
registers and subsequently branch to the interrupt routine. 

The 8259 has 8 inputs through which it accepts incoming interrupts 
from various sources. When an interrupt request occurs by one or more of 
the inputs IRO - IR7 going high, it raises the INTO input to the 8088 high. 
The 8088 in turn asserts NINTA two times. The 8259 will select one of the eight 
interrupt input sources for processing and when the 8088 sends the second 
pulse on NINTA, the 8259 will place a vector on the bus that corressponds 
to the interrupting device that is to be serviced. Should several 
interrupt requests come into the 8259 simultaneously, the 8259 chooses 
which one is to be processed first and which ones subsequently. 

The interrupts coming into the 8259 are prioritized as: 


Highast priority 

IRO 

Video 


IR1 

Datacomm (7201 and front plane interrupts) 


IR2 

+5V (Video second level tasks) 


IR3 

Keyboard and Touch Screen 


IRU 

Front plane interrupts (lower level) 


IR5 

HP-IB 


IR6 

(not used) 

Lowest priority 

IR7 

Real-Time Clock 


The 8259 can be programmed to handle incoming interrupts in a number of 
different ways. The system firmware puts it in the iAPX 86 mode, 
level- triggered and non-buffered modes. The 8088 programs the 8259 by 
writting various data bytes to it over the I/O bus. The 8259 can be 
programmed to ignore certain interrupts, handle incoming interrupts in a 
particular order, or even to work as a polling device if desired. 

The various ways the 8259 can be used are described in the 8259 data sheet and 
application note available from Intel. 


I/O Devices 

The I/O bus has eight functional modules which exchange data with the 
microprocessor. These modules are the 8259 A interrupt controller, the MM 58167 A 
real-time clock, the 8ll6T baud rate generator, the 8o4lA microcomputer which 
controls the keyboard and touchscreen, the 9914A HP-IB controller, 7201 
datacomm controller, and logic pertaining to datacomm on the fixed port (port 2) 
as well as the mezzanine datacomm board (port 1). Figure 3~9 illustrates the 
I/O bus modules. 
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Figure 3~9* I/O Bus Device Block Diagram 


I/O DECODING. One or more I/O ports are assigned to each device or module 
on the I/O bus to provide the reguired communication path with the CPU. The 
I/O map (presented in Section 4) lists the port addresses assigned to each 
device. An I/O bus cycle (one that is not an interrupt acknowledge cycle) is 

executed by the 8088 with the 10/ -M signal high, the NSSO signal high and the 

DT/-R signal low, or with I0/-M high, NSSO low and DT/-R high. During the I/O 
cycle the lower 16 bits of the address bus carry the port address being 
accessed. An OR and a HAND gate monitor BI0/-M, NSSO , and DT/-R to see 
if an I/O cycle is occuring. A 3 - line-to-8-line decoder with a NOR gate 
decode the address on the address bus and enable the 7201, the 9914, the 
8o4l, the 8259 > the 8ll6, or logic in one of the datacoram ports when an I/O 

bus cycle is issued by the 8088 to access one of these devices. A HAND 

gate, a NOR and an inverter are used to decode the addresses used by the 
real-time clock chip. 


KEYBOARD AND TOUCHSCREEN CONTROLLER. The interface between the 8088 and 
the keyboard is provided by a single chip microcomputer, an Intel 804l. 
Additionally, the 804l provides the interface to the touchscreen. 

The 804l interfaces to the 8088 over the data bus. Two I/O ports are devoted to 
it, ports 18H and 19H. The 8088 can send various commands to the 804l while 
the 8o4l can send information such as a key number or a touchscreen report. 
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Keyboard: The interface between the 804l and the keyboard depends on the 
synchronization of a hardware counter on the keyboard, and a software counter 
in the 8o4l. With each key clock the 8o4l sends to the keyboard, it 
increments the software counter. It then checks the data line for status of 
the currently addresed key. The contents of the software counter specify the 
correct key address. 

The KBDSYNC line provides a reset mechanism allowing the 8o4l to put the 
keyboard counter into a known state (count = 0). Thus the interface to the 
keyboard is provided by three lines: KBDCLK from 8o4l, KBDSYNC from 8041, and 
KBDDATA from keyboard. 

Touchscreen: The interface to the touchscreen is essentially identical to 
that for the keyboard. The most significant difference is that the touchscreen 
drives the TSSYNC line. The 804l must send clocks until the touchscreen 
activates the TSSYNC line to determine the state of the touchscreen counter. 
This provides a positive indication as to whether the touchscreen is 
present. Again, the interface is over three lines: TSCLK from the 804l, 
TSSYNC from the touchscreen, and TSDATA from the touchscreen. 

Bell: The 804l also provides the drive for the system bell. The on-board 
timer circuit is used to select the frequency of the bell tone. 

Circuitry between the 8o4l and the keyboard converts the TTL levels from the 
8o4l to 12 volt reference levels used on the keyboard. This is also true for 
the touchscreen. 

For a more detailed explanation of how the 804l interfaces to the keyboard and 
touchscreen see ”8o4l Keyboard/Touchscreen Scanner”, which is discussed later in 
this manual. 


DATACOMM. The HP 150 hardware provides two independent data comm ports. 
These ports provide a full complement* of signals and a large degree of 
flexibility for the system firmware to take advantage of. A description of 
these datacomm facilities is discussed later in this manual under "Datacomra 
Subsystem” . 


HP -IB CONTROLLER AND INTERFACE. The HP-IB controller used in HP 150 is the 
TMS9914A which is capable of handling the talker and listener functions, 
parallel and serial poll functions, and data handshaking functions required 
to implement the HP-IB standard protocol. SN75160 and SN75l6l bus 
transceivers are used to interface the controller to the HP-IB bus. 

The 991^ system clock is the 4 Mhz square wave generated by the 8284 (PCLK). 
The 991^ has 8 1/0 addresses assigned to it by which the CPU accesses the 
controller’s internal 14 registers to do HP-IP transactions. 

The 9914 can also generate an interrupt to the system at interrupt 
level 5 to receive CPU attention if the processor has enabled the interrupt 
facilities. -INT, the interrupt output signal is am open-drain active low 
signal which is pulled up and inverted for 8259 interrupt handling. 
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REAL TIME CLOCK. The HP 150 uses the MM 58167 CMOS real time clock (RTC) . This 
is a battery backed up component as is the CMOS RAM on the mezzanine 
memory board. When the main system power is turned off, the 3V battery and 
the associated circuitry maintains approximately 2.5V at the power supply pins 
of the CMOS parts. 

The ’58167 is a versatile chip. It interfaces to the system with an 8 bit bus. 
The RTC keeps track of the month, day of month, and day of the week as well 
as the time in hours, minutes, seconds, tenth seconds, hundreths and 
milliseconds. It is capable of producing repeated interrupts at the rates of 
1/month, 1/week, 1/day, 1/hour, 1/minute, 1/second and 10/second. An alarm 
feature allows an interrupt to be sent to the system at a designated time. 

Several components external to the chip are used in the oscillator 
circuit for the RTC. These include a variable capacitor which must be tuned for 
accurate time keeping with this circuit. The suggested way to calibrate the 
variable capacitor is to connect a frequency counter to the interrupt 
output of the RTC and program the chip to produce a repetitive 1 Hz 
interrupt. Adjust C28, the variable capacitor, until the period of the pulse is 
as close to 1 second as it will adjust to. 

A number of components are used to create the final signals used to drive the 
-RD and -WR inputs of the RTC. The ’58167 has some rather unusual address 
and data setup and hold times that require the creation of special -RD and -WR 
signals to meet the RTC’s timing constraints. 


IMOTE 


The millisecond register of the RTC is not very 
accurate. It is not recommended for use in critical 
time applications. 

The RTC interrupt status register cannot be polled! 
The status register must be interrogated after 
receiving an interrupt from the RTC. This is due to 
a race condition that exists in the chip that can 
cause an interrupt to be permanently masked if the 
status register is interrogated at the time the 
interrupt was about to occur. This implies that the 
RTC must not have its interrupt output shared in an open 
collector fashion with other devices unless it is 
always the last device to be polled in an interrupt 
service routine. 

The RTC can continue to drive the data bus as long as 
250 nsec after the -RD input is brought back high. A 
restriction that we have in the HP 150 system is that a 
read from the RTC cannot be followed immediately by a 
write to any device on the I/O bus. 
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VIDEO SUBSYSTEM 


The HP 150 Video Board provides the alphanumeric and graphics displays. This 
section of the manual describes in detail the workings of the board. The video 
board interfaces to the rest of the system through th6 front plane board. The 
interface signals and connector pinouts are described earlier in this section. 


Video Technology and Display Format 


RASTER SCAN. The HP 150 uses a RASTER SCAN display technology in a 
non-interlaced mode at a 60Hz refresh rate. The video is generated by 
scanning the CRT (cathode ray tube) with an electron beam. Electrons 
striking the phosphorous coating on the inside of the tube cause it to glow. 
Characters are displayed using dot patterns traced out by the electron beam. 

The HP 150’s display system consists of: 

1. Video Board 

2 . Sweep Board 

3. CRT 

The Video Board stores alphanumeric and graphics information in display RAMs. 
It then converts this information into a serial dot stream along with the 
necessary control signals and sends them to the Sweep Board. 

The Sweep Board is responsible for controlling the CRT. It transforms the 
digital signals it receives from the Video Board into analog signals necessary 
for manipulating the electron beam. 

The CRT acts as a transparent screen, onto which information is displayed. 
Electrons are generated in the back of the tube called the "electron gun." 
They are accelerated towards the front by the high voltage placed on the 

inside of the tube by the Sweep Board. The horizontal and vertical 
direction of the beam is regulated by a set of magnetic coils known as the 
"Yoke." The Yoke receives analog control signals from the Sweep Board also. 
See figure 3 _ 10 for a block diagram description of the video system. 
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Figure 3-10. Video Subsystem Block Diagram 


VIDEO FRAME FORMAT. Figure 3 - H shows the CRT pattern for the ALPHA display 
for one frame time. Part a) of the figure shows the begining of the frame when 
the electron beam is traced from the upper left portion of the screen to the 
lower right. Part b) shows the Vertical Retrace, when the beam is returned 
to the upper left of the screen, thus getting ready for the start of the next 
frame . For the sake of clarity, the following section refers to ALPHA 

display only. The relationship between Graphics and Alpha will be explained 
later . 

Looking at figure 3~H> the following events take place during an ALPHA 
display in one frame time: 

1. The beam starts out at the top of the tube in the "Start Scan Lines" area. 
The beam will not be allowed to turn on for the first 12 scan lines. 
This area is blanked so that the beam control signals coming from the 
Sweep Board have a chance to settle down before active video display. 

2. On the 13th seen line, the beam reaches the active display area and 
video data is displayed. Note that horizontal retraces are necessary 
to bring the beam back to the start of the next scan line. During this 
time, however, the beam is turned off. 

3. After all of the 378 ALPHA scan lines have been displayed we enter 
the 6 "Extra Scan Line" region, where the beam is blanked. 
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k. We reach the end of the "Extra Scan Lines" and the Sweep Board receives a 
Vertical Drive pulse, from the Video Board, telling it to do a 

vertical retrace. In part b), we see the beam returning to the top of the 
screen. The beam is blanked during the vertical retrace, so that we won’t 
see the zig-zag lines on the screen. (Note that horizontal retraces 
continue while this is taking place). 

One complete frame includes the following; 

- 12 Start Scan Lines 

- 378 Active Scan Lines 

6 Extra Scan Lines 

- 19 Vertical Retrace Scan lines 


Ul5 = scan lines per frame 


Each scan line is divided into its active (displayable) part, and the blanked 
(horizontal retrace) part as follows: 

- 80 displayable character times 

- 35 horizontal retrace character times 


115 = visible and non-vis ible characters per scan line 
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NOTE: 


= Horizontal Retrace 


= Blanked Video 


Figure 3-11. 


Alpha Display CRT Scanning 


ALPHA SCREEN FORMAT. Observing part a) of figure 3-12 we see that the alpha 
screen consists of a matrix of characters 27 rows X 80 columns. From here 
on, we will refer to them as Character Rows and Character Columns. Following 
is a table describing the different areas of the screen: 


Description Row Number 

24 user rows 1-24 

2 soft key rows 25-26 
1 status row 27 


27 rows = total displayable rows in one frame 
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Figure 3"12. Alpha Character Matrix and Cell 


DISPLAYING ALPHA CHARACTERS 

o The dot pattern for every character is stored in a Character ROM (Read 
Only Memory) . 

o Characters are displayed one scan line at a time. For example, in order 
to display one character row (80 characters), the following must be done: 

1. Fetch the 1st scan line pattern of char #1 from the Character ROM, then 
send it out to be displayed. 

2. Fetch the 1st scan line of the 2nd character, and send to the 
display. 

3. Repeat this until scan line 1 of all the 80 characters has been displayed. 
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4. Now perform 1,2,3 again, but with scan lines 2 and again with 3, etc., 
up to scan line 14 which completes the character row. 

o To display the entire screen of 27 character rows the above steps 1-4 
would be performed for each character row, a total of 27 times. 


ALPHA CHARACTER CELL FORMAT. Part b) of figure 3-12 indicates the dot 
matrix which makes up each character, known as the character cell. There are 
14 scan lines of 9 dot columns in each cell. 

The HP 150 character cell has the following components: 

Row 


1 

X 

X 

X 

X 

X 

X 

X 

X 

X 

Note: 


2 

X 

0 

0 

0 

0 

0 

0 

0 

X 

X = 

inter row/ column 

3 

X 

0 

0 

0 

0 

0 

0 

0 

X 


spacing 

4 

X 

0 

0 

0 

0 

0 

0 

0 

X 

0 = 

character dots 

5 

X 

0 

0 

0 

0 

0 

0 

0 

X 

3 = 

space 

6 

X 

0 

0 

0 

0 

0 

0 

0 

X 

cu = 

top half of double 

7 

X 

0 

0 

0 

0 

0 

0 

0 

X 


cursor, underline 

8 

X 

0 

0 

0 

0 

0 

0 

0 

X 


or underhang 

9 

X 

0 

0 

0 

0 

0 

0 

0 

X 

c = 

bottom half of 

10 

X 

0 

0 

0 

0 

0 

0 

0 

X 


double cursor or 

11 

X 

0 

0 

0 

0 

0 

0 

0 

X 


inter-row spacing. 

12 

X 

s 

s 

s 

S 

s 

3 

s 

X 



13 

c 

u 

c 

u 

c 

u 

c 

u 

c 



l4 

c 

c 

c 

c 

c 

c 

c 

c 

c 




1 

2 

3 

4 

5 

6 

7 

8 

9 

: Columns 



o Basic character cell contains the main body of the character called the 
Character Font. (All HP 150 characters are in a 7X10 font.) 

o Inter-row spacing is accomplished by blanking the first and last 

columns of the character cell 

o Scan line 11 is called the Print Line, on which lower and upper case 
characters are positioned. 

o Inter-column spacing is ensured by not putting character 

information in rows 1 and 14. (Except on certain Roman Extent ion 
characters where ascenders include row 1.) 

o Underline occupies row 13 

o Descenders reach down to row 13 
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There are two types of cursors on the HP 150: 

o The double scan line cursor occupies rows 13 and 14. It is a positive 
cursor, which means that it is logical OR-ed with whatever dots that 
may try to occupy the same row. 

o The "Blob” cursor takes up the entire character cell. It is am 
invertible cursor, which means that it will invert whatever dot pattern 
that may be inside the cell. 

o Both cursors are blinking types. 

Refer to figure 3-13 for a character cell example. Here we see the letter "A." 
As stated above, it takes up only a 7X10 space, leaving room for 
inter- character spacing. A few of the dots do not start at the beginning of 
the designated dot position. These are shifted over by a half -dot position to 
make the slanted lines look much smoother. 


Summary of Video Rates 


Frame Rate 
Scan line Rate 
Character Rate 
Dot Rate 


60 Frames/Second 
415 Scan Lines /Frame 
115 Characters /Scan line 
9 Dots/Character 


Multiplying the above numbers together will give a dots/frame rate of 
25,771,500 (or 25.7715 MHz). 


3-29 



Hardware Subsystems 



Figure 3~13* Character Cell Example 


ALPHA VIDEO ENHANCEMENTS. The HP 1J0 supports the following types of 
enhancements : 

- inverse 

- underlined 

- blinking 

- half -bright 

- security 

(Only alpha information is blanked out. 

It will not have any effect on other enhancements 
in the same character cell.) 

Any combination of the above enhancements may be defined for a character 
cell. 
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GRAPHICS DISPLAY. Graphics display is stored on the HP 150 using a RAM array, 
with each bit representing a graphics dot. The 8088 microprocessor writes the 
dot information into RAM, while the GDC3091 (U38) Graphics Display Controller 
fetches this information in a continuous manner. Every fetch involves the 
reading of one word ( 2 bytes ) from RAM, and once the data enters the GDC3091, 
it is serialized and shifted out at graphics clock rate. In this manner, all 
graphics scan lines are displayed. 

Graphics has a resolution of 390 vertical k 512 horizontal dots. Graphics 
dots are 1 1/2 times as thick horizontally as alpha dots. Since the Alpha 
Display only has 378 scan lines, the Graphics Display area overlaps it by 6 
scan lines on top and bottom oi the screen. Because they are wider, the 512 
graphics dots take up more room than the 720 alpha dots , and graphics 
overlaps alpha by about 16 grapics dots in the horizontal direction. 
Although the two displays are concentric in the vertical direction, they 
are slightly mismatched horizontally, as shown in figure 3 - l^. 

The physical size of the display is: 

Type Horizontal Vertical 

( mm ) ( mm ) 


ALPHA 150 116 

GRAPHICS 160 120 
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6 Scan Lines 


378 

Scan Lines 


u 


6 Scan Lines 


17 G Dots 


NOTE: 


= Graphics Boundary 
= Alpha Boundary 


720 Alpha Dots 


Physical Dimensions: 
Graphics = 1 60mm x 1 20mm 
Alpha = 150mm x 116mm 


512 Graphics Dots 


15 G Dots 


< — N 


390 

Scan Lines 


Figure 3 - l^* Display Specifications 


Video Board Overview 

The video board contains the digital logic used to display alpha and graphics 
information on the screen. Alpha information is addressed from a plane separate 
from graphics information. To do this, it performs the following functions: 

1. Stores the information to be displayed in alpha and graphics RAM. 

2. Produces an alpha dot stream. 
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3. Produces a graphics dot stream. 

4. Mixes the two dot streams and sends the resulting control signals to the 
sweep : 

NFB not full bright 

NHB not half bright. 

5. Provides deflection control signals used by the sweep; 

NVSYNC vertical sync 
HSYNC horizontal sync . 

Figure 3 - 15 shows the major components of the video board and the flow of data 
and control information between them. The following list provides a brief 
description of each of these components. 

1. Processor Request and Wait Generation: 

Decodes 8088 access to the alpha or graphics RAM producing signals used by 
the RAM controllers. Also inserts necessary processor wait states. 

2. Graphics RAM interface: 

Interfaces the 8088 and the Graphics Display Controller Chip (GDC-3091) to 
the graphics RAM. 

3. Graphics RAM: 

32K x 8 block of dynamic RAM which is used to store graphics 
information. Because the graphics is a bit map display the information is 
stored in that format. A portion of the RAM is also used by the alpha video 
firmware to store variables. 

4. Graphics Display Controller Chip: 

Custom gate array graphics controller which retrieves data from the 
graphics RAM and forms the graphics dot stream. Also provides graphics RAM 
timing signals. 

5. Alpha RAM controller: 

Interfaces 8088 to the alpha RAM and to the SMC 9^07 video controller. Also 
interfaces the SMC 9007 to the alpha RAM. 

6. Alpha RAM: 

12K x 8 block of static RAM which stores the alpha information to be 
displayed. 

7. SMC 9007 Alpha Video Controller: 

VLSI video controller which retrieves data from the alpha RAM and 
provides display signals needed to generate the alpha dot stream. 

8 . Character ROM : 

16K x 8 ROM which contains template for each alpha character. The ROM 

contains eight character sets. Each set contains 128 characters. 
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9* Alpha character display hardware: 

This hardware uses information from alpha RAM and the character ROM along 
with signals from the SMC 9007 and generates the alpha dot character stream. 
This stream does not include any enhancement information. 

10. Enhancement decoding logic: 

This hardware decodes the enhancement information. It produces signals used 
by the mixing hardware. 

11. Dot stream mixing hardware: 

Mixes the alpha and graphics dot streams with the enhancement information to 
obtain the signals NFB and NHB which are sent to the sweep. 

12. Clock generation: 

Produces various clock signals which are used by the other sections of the 
board. 

The following discussion outlines the events which must take place to obtain 
the video dot stream and other signals sent to the sweep. It also highlights 
the key points of implementation. 

To obtain an alpha dot stream the following happens: 

1. The 8088 writes control information to the SMC 9007 to initialize the 
controller. This establishes the VSYNC and HSYNC signals sent to the sweep 
as well as the other control signals produced by the SMC 9007. 

2. The 8088 writes the characters and enhancements to be displayed to the alpha 
RAM along with information needed by the SMC 9007 to retrieve the characters. 

3. SMC 9007 retrieves data from the alpha RAM and latches it into discrete TTL 
latches . 

h. This data is used to address the character ROM and generate the enhancements 
associated with the character. 

5. The dot stream generated from the character ROM information and the 
enhancement information is combined to form the alpha dot stream. 


NOTES: 1. Accesses to the SMC 9007 and the alpha RAM by the 8088 are 
synchronized to the SMC 9007 character clock. Also accesses by the 
SMC 9007 to the alpha RAM are synchronized to the character clock. 

2. 8088 and SMC 9007 alpha RAM accesses are time multiplexed within the 
character clock. In other words, part of the character clock is 
alloted to 8088 accesses and part is alloted to the SMC 9007. 
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To obtain the graphics display: 

1. The 8088 writes information to be displayed into graphics RAM. 

2. The Graphics Display Controller Chip retrieves the information and forms the 
graphics dot stream. 

NOTES: 1. The signal which initializes the Graphics Display Controller Chip is 

derived from signals generated by the SMC 9007- This means that the 
SMC 9007 must be initialized before the graphics display is enabled 
or the graphics RAM is accessed. 

2. Accesses to the graphics RAM by the 8088 and the Graphics display 
controller are syncronized to the graphics dot clock. The accesses 
are also time multiplexed within each graphics cycle, where one 
graphics cycle is 16 graphics dot clocks in length. 

To obtain the sweep signals: 

1. The alpha and graphics dot streams are combined using combinatorial logic. 
This logic produces the NFB and NHB signals which are sent to the sweep. 

2. The NHSYNC and MVSYNC signals are produced by the SMC 9007 and are buffered 
before being sent to the sweep. 


Notes on clock generation: 

1. The 8 MHz system clock is used by the request and wait generation circuitry 
to aid in sychronizig the 8088 RAM accesses to the video clocks. 

2. All clocks on the video board are derived from a 25*7715 MHz crystal. 
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KEYBOARD AND TOUCHSCREEN SUBSYSTEM 


Keyboard 


ELECTRICAL INTERFACE. The keyboard interfaces with the 8088 via an 804l 
microcomputer that creates the timing signals needed for communications. Power 
for the keyboard is delivered by the processor board through the keyboard cable. 
The 804l delivers a clock and sync signal to the keyboard while monitoring a key 
acknowledge return signal from the keyboard on one of the 8o4l’s timer inputs. 

The following signals are connected to the connector jack on the keyboard: 


Pin 1 SYNC — 

Pin 2 — — N.C. |3 2 1 | 

Pin 3 +12V j * * * | TOP VIEW 

Pin 4 Ground j ***** | 

Pin 5 CLOCK | 6 5 4 | 

Pin 6 KEY (return j j 


' \ 

I | Keyboard Cable Intry 
Figure 3-16. Keyboard Jack Detail 

The 804l creats a CLOCK signal that is non-periodic that averages just under 5 
KHz. The shortest time period is around 190 microseconds with a duty cycle near 
50%. The SYNC signal (active high) is designed to reset the keyboard to a known 
state with respect to the 804l. The KEY line is a return signal from the 
keyboard telling the 804l a key was depressed. 


KEYBOARD OPERATION. The 804l clocks the keyboard continually by pulsing the 
CLOCK line and sends out a synce pulse on the SYNC line after all the keys have 
been scanned. The sync pulse keeps the 8o4l in sync with the keyboard. 

After the 804l delivers a sync pulse to a seven bit counter on the keyboard, it 
resets it to zero. On the very next negative edge of the clock this counter 
begins to count. The three least significant bits of the counter control the 
inputs to an 8 to 1 multiplexer which monitors the 8 rows of the keyboard matrix 
(each clock pulse causes the multiplexer to scan a different row). The four 
most significant bits are controlling two BCD to decimal decoders which strobe 
each column of the matrix. The inputs to the 8 to 1 multiplexer are pulled down 
via a resistor. For a particular column address, an output of the decoders will 
be high. If a key in that particular column is depressed, one of the eight 
inputs to the 8 to 1 multiplexer will go high. As the least significant bits of 
the counter count through all eight rows of that column, the output of the 
multiplexer will go high when the row of depressed key is scanned. This logic 
one signal is returned to the 8o4l via a HAND buffer. The 8o4l keeps track of 
how many clocks were sent to the keyboard and can determine which key was 
depressed when the logic one was sent on the KEY line since there is a 
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one-to-one correspondence to the number of clock pulses sent and each key 
switch. 


Touchscreen 


NOTE 


The information presented here may be covered by one or 
more Hewlett-Packard patents. 


The touchscreen allows the determination of the X-Y coordinate of an object 
touching the screen. This is accomplished by placing infrared emitters along 
two sides of the grid, and photo-detectors along the other two sides, opposite 
the emitters. By turning on each emitter and checking the output of the 
opposite detector, it can be determined which pairs are blocked. A complete 
scan of the pairs results in an image of the object, allowing the determination 
of an X-Y coordinate. 


MECHANICAL DESCRIPTION. The touchscreen consists of a printed circuit board 
with a center cut-out. This mounts slightly in front of the CRT face, inside 
the bezel. The infrared beams pass through holes in the bezel and across the 
CRT face. 

Connecting the touchscreen p.c. board with the terminal is one 10 conductor 
cable. It plugs into the touchscreen board at the upper right hand corner, and 
into the front plane next to the sweep board connector. 

For ESD protection, the inside of the bezel insert is coated with a conductive 
paint. Contacting this paint is a spring clip mounted on the back of the upper 
right corner of the board. This clip is bolted to the PCA and connects through 
the pad to a quick disconnect on the front of the board. A ground cable runs 
from the quick disconnect to the chassis. 
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Figure 3 - 17* Touchscreen Block Diagram 
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SPECIFICATIONS 

Resolution: 27 rows by 40 columns 

Power Consumption: +12V § 70ma 

Interface: 6 signals; 

1. +12 

2 . ground 

3. -12 

4. TS CLOCK: should be driven with an open collector buffer 
pulled up on the T.S. board to 10 volts. 
(Period of 1.4 milliseconds or greater, 
active low, low time to be > 1.5 microseconds 
and less than 10 microseconds.) 

5 • TSDATA: high output is 10 volts. 

(Data out, low indicates that the currently 
addressed pair is interrupted. High 
indicates that the pair is unblocked.) 

6. TSSYNC: high output is 10 volts. 

(Synch out, active low, indicates that the 
ts counter is currently on 37 (43 base 8) 
and will roll over to zero on the next 
clock. ) 

Connector: J1 10 pin connector with key. 


! 1 l6 ! 

! +12 ! +12 ! 

i i j 

! ! 

! 2 1 7 1 

! TSDATA ! +12 ! 

! ! ! 

i !-- __i i 

!3 !8 ! k I 

! -12 ! GROUND ! e ! 

! ! ! y l 

! 1 j j 

j 4 19 1 

1 TSSYNC ! TSCLOCK 1 

1 1 1 

1 1 1 

!5 110 1 

! GROUND ! GROUND l 

1 1 1 
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TIMING 



| 1.4 ms min 
| no max 

1 

1 

1 1 <- 
1 1 <- 

1.5 micro sec min 
10 micro sec max 

tsclock 

\j 

\_/ 

\J 

\J 

count 33 

\/ 3^ 

/\ 

\/ 35 

/\ 

\/ 3 i\r 
/\/\ 

0 0 


tssync \ / 


tsdata / \ 

unblocked blocked 


uuu / 

bad emitter undefined unblocked 


o Delay from falling edge clock to data valid = 0.8 msecs maximum. 

o Mo pair exists at decimal count 21, thus data will always be high at this 
count. 


INTERFACE DESCRIPTION. In the HP 150, a single chip microcomputer, an 8o4l, 
provides the interface to the touchscreen. Within the 8o4l, a software count is 
synchronous with the touchscreen hardware counter. As the 8o4l sends clocks to 
the touchscreen, it increments this software count and checks the data line. 
When the data shows a blocked pair, the software count specifies which pair is 
blocked. By keeping track of which pairs were interrupted in a scan cycle, the 
8o4l can determine if a valid hit has occurred. If so, the hit is reported as 
one of 27 rows and one of 4l columns. (0-26, O-UO). 

The general scheme for this is as follows: 

1. While sync not active send clock (^synchronize count*) 

2. Set count = 00 

3. For count = 0 to 36 

send clock 

wait 1.4 milliseconds 
check data 

if data = block store count 
end 

4. Check synch 

5. If synch is not active then error - GOTO step 1 
else check blocked count numbers for a valid hit 

6. If valid hit then report to system processor 

7. GOTO step 2. 
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Valid Hits : At least one interrupted pair in the column range and at least one 
interrupted pair in the row range. More than one pair, in row or column space, 
is okay as long as the multiple, interrupted pairs are adjacent. (Example: pair 
3 interrupted, and pair 5 interrupted is an error condition.) 

No Hit : This would be a scan cycle which finds no pair interrupted. 

Error Conditions : 

1. An interrupted row pair, but no interrupted column pair. 

2. An interrupted column pair, but no interrupted row pair. 

3. Multiple hits: If any two interrupted row pairs are separated by one or more 
uninterrupted pairs. Likewise for columns (i.e., two distinct objects are 
touching the screen) . 

4. Out of synch: At the end of a scan cycle, the synch should be active. If 
this does not occur, a reset should be done. 

If an error condition is found, no hit is reported. 


RESOLUTION VERSUS NUMBER OF PAIRS. The resolution of the touchscreen is 
greater than the number of pairs used. This is accomplished by averaging the 
data. That is, if two adjacent pairs are interrupted, the row or column between 
the two is the one desired. Thus the resolution is effectively doubled, except 
for edge effects. 

This requires that the distance between the adjacent pairs be less than the 
minimum stylus diameter. 

Thus, if any single row or column is interrupted, that is the one desired. If 
an even number of adjacent beams are interrupted, the result is the center, 
’half’, address. If an odd number of pairs are interrupted, the result is the 
center beam. 


PAIR ADDRESS TO ROW, COLUMN NO. CONVERSION. The pairs are positioned above 
and below the CRT as follows : 

1 2 3 4 5 

321012345678901234567890123456789012345678901234567890123456789 

xxxxxxxxxxxxxxxx 

0 l 2 3 4 5 6 7 8 9 10 11 12 13 14 15 

Column No. 6 7 8 

012345678901234567890 

X X X X X 

Pair No. 16 17 18 19 20 

Thus, across the top, the pairs are positioned every fourth column. This leads 
to a resolution of 4o vertical divisions, each division = 2 columns. 
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The pairs are actually offset to the space between 2 adjacent columns, starting 
at the space between columns -2, -1 and repeating every fourth column until the 
space between column 78, 79* This causes an offset which should be corrected at 
the system processor level. The effect is that the 8o4l will report column 
pairs in the range 0 to 40. This is one more division (two columns) than on the 
display. To correct for this, the following should be done: 

Multiply the column report by 2 => changes range from 0-40 -> 0-80 

Subtract 2 => changes range from 0-80 -> -2-78 

If negative then set result=0 => changes range from -2-78 -> 0-78 

This corrects for the offset of the touchscreen hardware with respect to the 
display. 

The pairs are positioned along the sides of the CRT as follows: 


T.S. 

Display 

Pair 

Row 

0 

0 


1 

1 

2 


3 

2 

4 


5 

3 

6 


7 

4 

8 


9 

5 

10 


11 

6 

12 


13 

7 

l4 


15 

8 

16 


17 

9 

18 


19 

10 

20 


21 

ii 

22 


23 

12 

24 


25 

13 

26 


The rows are a straight forward mapping of the row number reported by the 804l 
into the rows of the display. The report need only be multiplied by 2. 
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8041 Keyboard/Touchscreen Scanner 

A description of the operation of the 804l peripheral processor used to scan the 
keyboard and touchscreen follows. A complete description of the commands used 
to control the 804l is included. 


NOTE 


The information presented in this manual with respect to 
the touchscreen may be covered by one or more 
Hewlett - Packard patent s . 

BLOCK DIAGRAM. The keyboard said touchscreen are both scanned by an 8o4l 
peripheral processor. 


| HP 150 | 

| FIRMWARE I 


1 

1 

1 

1 

1 

1 

1 

1 

STATUS 
REGISTER 
(A0=1) 
Read Only 
(0019H) 

1 

1 

COMMAND 
REGISTER 
(A0=1) 
Write Only 
(0019H) 

1 

1 

DATA 
REGISTER 
(A0=0) 
Read Only 
(0018H) 

KB KB 

RESET CLOCK 
P17 P10 

KB TS 

DATA SYNC 
T1 TO 

TS TS 

CLOCK DATA 
P23 P22 

1 1 

I | 

/l\ /l\ 

1 1 

1 1 

i /l\ 

I | 

\l/ \l/ 

1 1 
\l/ 1 

KEYBOARD 

1 1 
1 1 

| | TOUCHSCREEN 

1 1 
1 1 
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STATUS REGISTER (I/O PORT 0019H). The 804l status register contents are 
obtained by reading from the 8o4l at I/O port address 0019H. It has the 
following format: 


Interpretat ion 


7-4 Four status bits controlled by the 8o4l 
program. These are used to qualify the 
data values sent to the HP 150 processor 
by the 8o4l. 


3 FI flag. Used internally by the 8041. 

2 FO flag. Used internally by the 8o4l. 


1 IBF flag. Set when the HP 150 processor 

writes to the 804l and cleared when the 
804l accepts the data. 


0 OBF flag. Set when the 8o4l has data 

available for the HP 150 processor and 
cleared when the host reads from the 
8041 with AO = 0. 


INITIALIZATION. The following actions will leave the 8o4l in its initialized 
state : 

o Power on 

o Hard reset from keyboard 
o Hard reset command from HP 150 processor 
o Initialization command from HP 150 processor 

After initialization, the 8041 will not scan the keyboard or touchscreen until 
an "enable scanning" command is given. About 200us after initialization 

commences, status bits 7-4 will be 0001 if the reset was from power-on or 0010 
otherwise. The initialization continues and attempts to synchronize with the 
touchscreen. The entire initialization takes up to 100 ms. 

The recommended start-up procedure for the 804l after any of the four 
initialization actions listed above is: 

1. Wait 100 milliseconds for the 804l to initialize itself and check the 
touchs creen . 

2. Send self -test command and wait for results to come back. 

3. Send indentify keyboard command and wait for results to come back. 

4. Enable scanning. 
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8041 COMMANDS (I/O PORT 0019H). These commands must only be written to the 
command buffer of the 804l (I/O port 0019H). 


Command Code 


Function 


08H Stop bell immediately. Next bell will function normally. 

10H Release interrupt line. 8o4l will negate its interrupt 

request to the host. 

20H Hard reset. 8o4l will assert its reset output to the HP 150 

processor and initialize itself to power-on state with the 
exception of 8o4l status flags (see preceding discussion on 
8o4l status register) . Scanning must be re-enabled for 
keyboard or touchscreen input. 

21H Identify keyboard. 804l will respond with either 7FH or FFH 

depending on whether the keyboard identification diode is 
present or not. The 804l generates an interrupt to the host 
when the ID is ready. Status bits J-k will be 0000 if 
touchscreen is defective and non-zero if the touchscreen is 
working. 

22H Keyclick off. 8o4l will not make keyclick sound when keys 

are pressed. 

23H Keyclick on. 8o4l will make keyclick sound. 

24H Enable Scanning. After power-on or hard reset, 8041 will not 

scan keyboard or touchscreen until command is given by the 
host. 

25H Initialize 8041 to power-on state except for status flags. 

Scanning must be re-enabled by HP 150 processor for keyboard 
or touchscreen input. This command does not reset the HP 150 
processor. 

26H Self -test 8o4l. The 8o4l will test its RAM and ROM and 

respond with F9H if it passes or F8H if it fails. No HP 150 
processor interrupt will be generated; the status register 
must be polled until data is available. 

28H Stop key repeat. Any key on the keyboard will auto repeat 

after 500 ms if held down. If the HP 150 processor does not 
want the current key to auto repeat, it must send this 
command to stop it. 

2 AH Disable hard reset. This command will disable the hard reset 

that is initiated by the control/ shift/reset combination. 

2BH Enable hard reset. This command enables the keyboard hard 

reset. (Default) 
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Beep bell. The bell duration is about 100 ms and its period 
is determined by the lower four bits of the command code. 
With a 5 MHz 8o4l clock, the frequency is about 290 Hz for 
30H and about 1.7 KHz for 3FH. 

Do one keyclick immediately. Ignored if keyclick is 
disabled. 

Touchscreen detector pairs report. This command is used to 
determine if any LED/Transistor pairs appeared to be blocked 
or bad during initialization. Two data bytes are always 
returned after this command is given. If either or both are 
not OFFH, then their values are the addresses of the blocked 
pairs. If both are OFFH, then there are no blocked pairs. 
No interrupt is generated for these two bytes ; the 8o4l must 
be polled for them. This command must be given after 
initialization and before scanning is enabled because it will 
interfere with the interrupt system if the 8o4l is attempting 
to report keycodes. 
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Table 3 - l* Ired vs. PT 


decimal 

Count 

Address 

Hex 

0 

00 

1 

01 

2 

02 

3 

03 

4 

04 

5 

05 

6 

06 

7 

07 

8 

08 

9 

09 

10 

0A 

11 

0B 

12 

OC 

13 

0D 

14 

0E 

15 

OF 

16 

10 

17 

11 

18 

12 

19 

13 

20 

14 

21 

15 

22 

16 

23 

17 

24 

18 

25 

19 

26 

1A 

27 

IB 

28 

1C 

29 

ID 

30 

IE 

31 

IF 

32 

20 

33 

21 

34 

22 

35 

23 

36 

24 


Address 

Octal 

Ired 

CR_ 

00 

36 

01 

35 

02 

34 

03 

33 

04 

32 

05 

31 

06 

30 

07 

29 

10 

28 

11 

27 

12 

26 

13 

25 

Ik 

24 

15 

23 

16 

22 

17 

21 

20 

20 

21 

19 

22 

18 

23 

17 

24 

16 

25 

blank 

26 

2 

27 

3 

30 

4 

31 

5 

32 

6 

33 

7 

34 

8 

35 

9 

36 

10 

37 

11 

40 

12 

4l 

13 

42 

14 

43 

15 

44 

reset 


Photo -Trans istor 
Q- 


21 

20 

19 

18 

17 

16 

15 

14 

13 

12 

11 

10 

9 

8 

7 

6 

5 

4 

3 

2 

1 

blank 

22 

23 

24 

25 

26 

27 

28 

29 

30 

31 

32 

33 

34 

35 

reset 
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KEYBOARD AND TOUCHSCREEN DATA INPUT (I/O PORT 001 8H). When data is 
available as a result of key presses or touchscreen touches, the 8041 will write 
to its output register and signal an interrupt request to the HP 150 processor. 
Data is buffered one byte deep in the 80Ul. If the previous byte written by the 
8041 to its output register has not been read by the HP 150 processor, it will 
wait. Otherwise, it will resume scanning. Bits 7-4 of the status register are 
valid when the data register is valid. They are used to indicate the type of 
data available. The status values are: 

0000 - Key address. If bit 7 of the data byte is 0, the 

key was depressed, else the key was released. 

Exception: If the data is in response to an 

Identify Keyboard command, then 0000 means the 
touchscreen is not connected. 

0001 - Power on (valid until first write). 

0010 - Reset (valid until first write). 

0011 - Touchscreen release code. Data is 0. 

0100 - Touchscreen row address. Same as screen row. 

0101 - Touchscreen column address. Same as screen column/2. 

1000 - Calculator command is complete. Data is 0 if 
command was not read from calculator. 

1111 - Only occurs after Identify Keyboard command; indicates 
that touchscreen is connected. 


NOTE 


These status bits are valid only when data is available 
(OBF flag = 1). The only exception to this is the 
power-on/reset status which become valid 200 
microseconds after reset or power-on and remains valid 
until the first write to the 8o4l. 


After reading the 8o4l data register, the host MUST send a release interrupt 
command to the 8o4l to acknowledge receipt of the data. (Except for self -test 
results and touchscreen bad pair addresses, which are reported without setting 
the interrupt lines . ) 

Data from the touchscreen always comes in pairs of bytes, each row address will 
be followed by a column address. As soon as the touchscreen scanner completes a 
scan without any touches, the 8041 will report a touchscreen release code. 
Touchscreen row/ column reports will be generated each time a new touched 
position is detected. The only way that the same position can be reported twice 
in a row, is when the screen is released between touches. In this case, a 
release code will be sent between touch reports. 
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DATACOMM SUBSYSTEM 
General Description 

The data communication (datacomra) electronics of the HP 100 Series Personal 
Computer allows the computer to communicate with other computers, mainframes , or 
peripherals via a serial data stream. The HP 150 has two serial EIA Standard 
RS232C (CCITT V.22) datacomm ports; Port 1 which is designed for communication 
with other computers either directly or using a modem, and Port 2 which is 
designed primarily for use with peripherals such as RS232C printers, but also 
can be used for computer commun i cat ions . 

The principal components in the datacomm circuit are the baud rate generator 
chip and the serial controller chip, both of which are on the I/O bus of the 
8088. The baud rate generator chip supplies the timing needed for data 
serialization for both ports independently and the Multiprotocol Serial 
Controller chip (MPSC) controls both of the datacomm ports. During 
communications, the 8088 writes and reads 8-bit data to and from the MPSC 
which serializes or deserializes the data from the proper port. The rate of 
data serialization is governed by the timing sent to the MPSC by the baud rate 
generator. 


RS232C/422 Datacomm Module Connector 

A 36 pin connector, J3 on the Processor PC A, interfaces the RS232C/422 
datacomm module to the system. The connector signals are: 


1. 

+12V 

13. 

N.C. 

25. 

DATA 7 

2. 

+5V 

14. 

NBRD 

26. 

DATA 6 

3. 

NRxC(l) 

15. 

GND 

27. 

DATA 5 

h. 

NRR(l) 

16. 

--- 

28. 

DATA 3 

5. 

GND 

17. 

— 

29. 

DATA 1 

6. 

RD(1) 

18. 

— 

30. 

xl6 CLK(l) 

7. 

NTR(l) 

19. 

-12 V 

31. 

NSELB 

8. 

GND 

20. 

+5V 

32. 

NWRT 

9 - 

DATA 4 

21. 

NTxC(l) 

33. 

NRST 

10. 

DATA 2 

22. 

NCS(i) 

34. 

— 

11. 

DATA 0 

23. 

NRS(l) 

35. 


12. 

GND 

24. 

SD(1) 

36. 

— 
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The numbering scheme for the connector goes from 1 through 36 with pins 16, 
17, 18, 34, 35 » and 36 undefined and physically absent on the 36 pin 

connector. The signals are defined as: 

DATA 0 - The eight bit interconnect to the 8088 I/O bus. 

DATA 7 

NRxC(l) Receive timing input to the 7201 datacomm controller 
NTxC(l) Transmit timing input to the 7201 controller 
xl6 CLK(l) Baud rate generator output 

NRR(l) Receiver Ready 

NTR(l) Terminal Ready 

NCS(l) Clear to Send 

SD(1) Send Data 

RD(1) Receive Data 

NRS(l) Ready to Send 

NRST System Reset 

NBRD 8088 read cycle 

NWRT 8088 write cycle 

NSELB (not used) 

Baud Rate Generator 

The baud rate generator used in the HP 150 is the SMC 8ll6T Dual Baud Rate 
Generator which can supply two independent baud rates based on a single 
input clock. It consists essentially of a pair of programmable dividers 
using an input frequency of 4 MHz. The user defines a baud rate which the 
8088 translates into an 8-bit value which is written into the 8ll6T at I/O 

address XXOC hex, the most significant 4 bits of which set the baud rate for 

Port 2 and the least significant 4 bits set the baud rate for Port 1. The 
timing outputs then connect to the proper port or channel timing inputs on the 
MPSC. 

The 8ll6T, in this application, generates clock frequencies for asynchronous 
data communications only. Asynchronous communication requires that the input 
clock frequency be 16 times the transmission baud rate, e.g. for a baud rate 
of 300 baud, a clock frequency of 4.8 KHz is required to serialize and 

deserialize the data. See the "Memory and I/O Mapping" section of this manual 

for 8ll6T programming information. 

The clock frequencies for Port 2 tie directly into the Transmit and Receive 
clock inputs of the MPSC and are always the baud rate times 16. 
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The clock frequencies for Port 1 go to the datacomm interface for Port 1 and 
into a multiplexer, the outputs of which tie to the Transmit and Receive clock 
inputs of the MPSC. The multiplexer allows the selection of the 8ll6T clock, 
the times-one clock, or the Send timing clock as the Transmit clock input to 
the MPSC. It also selects the 8ll6T clock, the times-one clock, or the Receive 
timing clock, respectively as the Receive clock input to the MPSC. A latch 
drives the mulitplexer select inputs and is accessed by writing the bit patterns 
as described in the "Memory and I/O Mapping" section of this manual. 

The times-one clock is derived by dividing the 8ll6T clock output by 16 giving 
a clock of the same frequency as the transmission baud rate. This clock is 
available to support some modems which require a times-one clock for data 
transmission. Even though the Transmit and Receive clocks may be configured to 
use the times-one clock, the communication protocol always assumes asynchronous 
communication. 


Multi-Protocol Controller 

All of the data communi cat ions in the HP 150 are controlled by the MPSC, 
which is a dual-port communications chip. Channel A on the chip controls 
communication to Port 1 while channel B controls Port 2. The chip is capable of 
being configured to do all of the data serialization and deserialization, 
stop/start bit insertion and deletion and parity bit insertion and 
deletion. The chip also controls standard communications status lines on 
each port through internal registers such as Terminal Ready (TR) (CD), Clear 
to Send (CS)(CB), Receiver Ready (RR)(CB), and Request to Send (RS)(CA). The 
data is transmitted from each port on the Send Data line (SD)(BA) and received 
on the Receive, Data line (RD)(BB). The data received or transmitted is 
accessed by the system CPU by addressing the data register for the proper 
port. The chip also provides a FIFO three-byte receive buffer to prevent 
incoming data overrun. 

The chip is also capable of interrupting the CPU upon receipt or transmission 
of a character. The Interrupt Request output is tied to the second priority 
interrupt input of the interrupt controller. This is an open-collector output 
and is shared with the open- collector datacomm request line coming from the 
accessory slots (NDCOCINT) . In addition to interrupts on character 
transmissions, the MPSC also generates interrupts on parity errors and changes 
in status of the communication control line inputs, freeing the CPU from polling 
these on each character transmission. 

The internal logic of the MPSC chip (aside from transmit and receive logic) runs 
on the system 4 MHz clock (PCLK) and the chip is reset by system resets (NRST) . 
The Transmit and Receive clock signal inputs used for channel B (Port 2) are 
tied together and are always derived from the baud rate generator times-l6 
clock. The Transmit and Receive clocks for channel A are driven independently 
from the Port 2 interface circuit (see Baud Rate Generator) . The chip’s Ready 
outputs for synchronization With the CPU are not used since this function is 
accomplished by always asserting an extra cycle in I/O accesses which should 
satisfy access times for this part. The MPSC also has Interrupt Priority 
inputs and outputs which are not used in this system. 
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Communications Interface Circuitry 

The circuitry interfacing the MPSC to the communications circuitry consists 
primarily of line drivers (MC1U88 ) and receivers (MCI 489 ) which convert the 
MPSC TTL levels to RS232C transmission levels (+12V/-12V). The RS232C standard 
requires that driver outputs must not exceed a slew rate of 30 volts per 
microsecond. All driver outputs are tied to a 470 pf capacitor which provides 
an effective slew rate of 21.3 volts per microsecond maximum (assuming 
short circuit current). The receiver gates (MCI 489) have "response control" 
inputs which allow filtering of high frequency noise pulses. The 470 pf 
capacitor used should filter noise faster than 100 ns in the 12V range. Both 
Port 1 and Port 2 use these parts for interfacing to the communications 
channel. The signal interconnection for both ports is shown in table 3”2. 

Table 3-2 . Datacomm Interconnect List 


Connector pin | Port 1 1 

| Signals | 

1 1 

Port 2 
Signals 

i 

| Shield (AA) | 

Shield (AA) 

2 

1 SD(BA) | 

SD(BA) 

3 

| RD(BB) /RD.A* j 

RD(BB) 

4 

1 RS(CA) | 

RS(CA) 

5 

| CS(CB) | 

CS(CB) 

6 

| DM(CC) | 

DM(CC) 

7 

1 SG(AB) | 

SG(AB) 

8 

| RR(CF) | 

RR(CF) 

9 

| SD.A* ! 


10 

| SD.B* | 


12 

| 0CR2 ( SCF ) j 

0CR2(SCF) 

15 

| ST(DB) j 


17 

| RT(DD) | 


18 

| RD.B* j 


19 

j 0CD2 (SCA) j 

0CD2 (SCA) 

20 

| TR(CD) j 

TR(CD) 

22 

j OCRl(CE) j 

OCRl(CE) 

23 

j OCDl(CH) j 

OCDl(CH) 

24 

j TT(DA) j 



Represents RS422 signal. 
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The control lines 0CD1, 0CD2, 0CR1, 0CR2 and DM are not connected directly to 
the MPSC, but are tied to the CPU data bus through handshake capability with 
certain kinds of equipment that require them (e.g. printers, modems, etc.) and 
are all available on both ports. I/O ports ihH and l6H access these control 
lines on Ports 1 and 2 respectively as described in the "Memory and I/O Mapping" 
section of this manual. 

Port 1 differs from Port 2 in two major respects; Port 1 contains timing 
signals on the RS232C interface as well as RSU22 signals on pins that are not 
used by RS232C in most HP applications (those pins are reserved for Data Set 
Testing in the RS232C definition) . The timing signals added are Transmit 
Timing (TT) (DA) , Send Timing (ST)(DB), and Receive Timing (RT)(DD). The Send 
and Receive timing signals allow an external device to drive the MPSC clock 
inputs for serialization. The Transmit Timing signal is always the same as the 
MPSC input tranmission clock. 

The RS422 interface consists essentially of a differential driver and receiver 
(75179) in place of the RS232C drivers. These drivers transmit and receive 
differential voltages with respect to the opposite signal line as opposed to 
referencing ground . Note that the RS232C signal RD(BB) and the RS422 signal 
RD.A are shared in this application. This is accomplished by pulling down the 
opposite driver input to create the proper translation to TTL level signals 
when the RS232C cable is connected. The selection between RS232C and RS422 is 
simply a matter of connecting the cable which connects to the proper signals. 
Since the receive signal comes into the same gate and the transmit signal 
drives both interfaces in parallel, the difference is transparent to the MPSC. 
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MEZZANINE MEMORY SUBSYSTEM 


Mezzanine Memory PCA 
PCA Overview 

The HP 150 mezzanine memory PCA (assembly U56II-60006) houses ROM, dynamic 
RAM, CMOS RAM, and system status LEDs on a PCA in a mezzanine position between 
the processor and video PCAs. The PCA is supported by four standoffs mounted 
on the processor PCA and electrically interfaces to the processor PCA through 
a 60 pin connector. The block diagram of the PCA is shown in figure 3~l8 . 
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Figure 3~l8. Mezzanine Memory PCA Block Diagram 
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Connector Signals 

A 60 pin connector, J2 on the Processor PCA, connects the ROM and user RAM 
to the rest of the system. The signals on the interface are listed below: 


Mezzanine Memory Connector Signals 


60. 

NSL0TSEL1 

30. 

+5V 

59. 

ABUS 11 

29. 

ABUS 19 

58. 

NSL0TSEL2 

28. 

ABUS 9 

57. 

ASCHOLD 

27. 

NPWRDN 

56. 

ADI 

26. 

ADO 

55. 

AD3 

25. 

AD2 

54. 

AD5 

24. 

AD4 

53. 

ad6 

?3. 

DT/-R 

52. 

ABUS 5 

22. 

AD7 

51. 

ROMSEL 

21. 

ABUS 16 

50. 

ABUS 17 

20. 

ABUS 14 

49. 

ABUS 18 

19. 

BCLK 

48. 

ABUS 12 

18. 

ABUS 13 

47. 

NCMOSSL 

17. 

NCMSWRT 

46. 

ABUS 4 

16. 

MXR1 

45. 

+5V 

15. 

GO 

44. 

FULLMEM 

14. 

+5V 

43: 

+5V 

13. 

BDEN 

42. 

ABUS 7 

12. 

CMOSPWR 

4l. 

GND 

11. 

GND 

40. 

+5V 

10. 

GND 

39. 

GND 

9. 

NRWRT 

38. 

NCMSOE 

8. 

SHOLDA 

37. 

ABUS 5 

7. 

ABUS 6 

36. 

BI0/-M 

6. 

NBRD 

35. 

ABUS 8 

5. 

ABUS 10 

34. 

+5V 

4. 

ABUS 3 

33- 

ABUS 1 

3. 

GND 

32. 

NRST 

2. 

NMSEL 

31. 

ABUS 2 

1 . 

ABUSO 


The mezzanine memory PCA connector signals are described below: 

ABUS 0-19 The demultiplexed 20 bit address generated by the 

8088 during a bus cycle. 

AD 0-7 Least significant 8 bits of the multiplexed 

data/address bus. Data is transferred to and 
from the memory PCA over these lines. 
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NSL0TSEL1 

NSLOTSEL2 

GO 

BCLK 

BIO/-M 

DT/-R 

BDEN 

HERD 

RRWRT 

ASCHOLD 

SHOLDA 

NMSEL 

NXR1 

ROMSEL 

FULLMEM 

NMEMRST 

NCMOSSL 

NCMSOE 

NCMSWRT 

CMOSPWR 


Signal indicating sin address within the 64K block 
allocated to accessory module 1 (90000H - 9FFFFH) has 
been generated by the 8088. 

Same as NSLOTSEL1 but is asserted when the address 
is in the address space allocated to accessory module 
2 (A0000H - AFFFFH) . 

Signal which qualifies the address generated by 
the 8088. GO goes high at the beginning of T2 and 
goes back low at the beginning of T4 of a bus 
cycle . 

Buffered 8 Mhz system clock. 

Buffered 10/ -M signal from the 8088. 

DT/-R from the 8088. 

Inverted and buffered -DEN signal from the 8088. 

Buffered -RD signal from the 8088. 

Buffered -WRT signal from the 8088. 

Asynchronous HOLD request generated by the memory 
PCA and sent to the 8088. 

Synchronized (with the 8 Mhz clock) HOLD 
acknowledge from the 8088. 

Signal if high prevents write to dynamic RAM. 

Transceiver control signal generated by memory 
PCA. 


ROM access indicator which causes the processor 
PCA to eliminate wait state on the bus cycle. 

When high indicates 256K RAM loaded on the memory 
PCA. When low indicates 128K RAM loaded. (A 
pull-up resistor external to the memory PCA is 
used to pull high.) 

System reset line for the memory PCA. 

CMOS RAM select line active low. 

CMOS RAM output enable active low. 

When low causes a write into CMOS RAM. 

Battery backed -up power source for the CMOS RAM. 
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NPWRDN Goes low to indicate an imminent power interruption 

to the system and puts the CMOS RAM into the 
standby mode. 

ROM 


ROM DECODING. Five 32K x 8 ROMs contain the system firmware used by the PC. 
These ROMs are located in the memory map as follows: 


ROM 

Memory Address 

(ROM 5) 

0F8000H - OFFFFFH 

(ROM 4) 

0F0000H - 0F7FFFH 

(ROM 3) 

0E8000H - OEFFFFH 

(ROM 2) 

0E0000H - 0E7FFFH 

(ROM 1) 

0B0000H - 0B7FFFH 


For a particular ROM to be selected, an address within the memory space 
allocated to it must be generated by the 8088, the 8088 control signal 
IO/-M (becomes BIO/-M after buffering for the memory PC A) must be low, and 
NBRD (buffered read strobe control signal froran the 8088) must be asserted 
(active low). The decode circuitry for ROMs 2,3,4, and 5 decode address lines 
ABUS 19, 18 18, 17, 16, and 15 when BIO/-M is low and assert the chip select 
input of the ROM whose contents is at the address generated by the processor. 
The 8088 receives data from the memory (or writes to RAM or the LED register) 
through a transceiver on the memory PCA. This transceiver is enabled when ROM, 
CMOS RAM, dynamic RAM, or the LEDs are accessed. 


WAIT STATE DISABLE. Every bus cycle (memory or I/O operation) of an 8088 
consists of four system clocks unless logic external to the 8088 dictates 
that the cycle be extended by some integer number of additional clocks. The 
wait state generation circuitry on the processor PCA inserts a minimum of 1 
additional clock period into all bus cycles unless a ROM access is being made. 
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ROM TIMING. The memory address from the 8088 becomes available to the memory 
PCA 85 nsec after the beginning of T1 . The propagation delays until data is 
available to the processor is as follows: 


ROM 1 Access 


ROMs 2~5 Access 


address valid 
chip select delay 
ROM access time 
buffer delay 
connector delay 
total delay 


85 nsec 
31 nsec 
200 nsec 
12 nsec 
2 nsec 
330 nsec 


address valid 
chip select delay 
ROM access time 
buffer delay 
connector delay 


85 nsec 
29 nsec 
200 nsec 
12 nsec 
2 nsec 
328 nsec 


The cycle is 375 nsec long (T1 + T2 + T3). The data setup time for the 8088 
is 20 nsec. Therefore, the data read margin is 375" 20-330 = 25 nsec. Note that 
the output enable inputs to the ROMs have been asserted worst case 120 nsec 
after the beginning of T1 so that ROM address access time, not ROM output 
enable time, is the limiting factor in ROM access timing. 


Slot Selection Generation 

The HP 150 package provides two PCA slots for handling optional module PCA 
devices. The HP 150 architecture provides a flexible interface to the accessory 
slots. Accessories can be accessed through either memory or I/O access (see 
memory and I/O maps). 

I/O addresses XX80 through XXFF have been reserved for accessory module use. 
This provides 128 I/O ports that can be decoded and used for processor and 
auxiliary device intercommunication. The most flexible arrangement that cam be 
used for accessory module device interfacing to the 8088 is the memory 
mapped interface with slot select. A memory address within the 90000 - 9FFFF 
range causes Slot Select #1 on the front plane connecting to the external 
module slot #1 to be asserted and an address within A0000 - AFFFF causes 
Slot Select #2 to be asserted. 


CAUTION 


It is highly recommended that only l6K of address 
space be used for either of the accessory cards. 
The address ranges 90000-93FFF and A0000-A3FFF for 
slot 1 and slot 2, respectively, should be exclusively 
decoded and used even though the slot select lines 
provide 6UK of address space. Accessory cards using 
memory space outside this range may not be compatible 
with any enhanced future versions of the HP 150. 
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What does the slot select scheme provide? An accessory PCA may choose to use 
or not to use the slot select line. If a device does not utilize slot 
select, a decode of at least the most significant four address bits must 
be done to detect a CPU access. More decoding of the least significant 16 
address bits must be done depending on the nature of the PCA and its 
circuitry. In addition, the user must never plug PCAs into Slots #1 and #2 
which become selected on the same address range. When fully decoding the 
address space, boards must be designed for a specific accessory slot. 

Using the slot select lines, a more limited decode is required on the accessory 
PCA since the four most significant bits are decoded by the CPU in asserting 
the slot select line. Therefore, an accessory PCA can detect an access by 
decoding slot select and the appropriate subset of the least significant 16 
address bits. The decode of slot select ensures that no contention will 
occur between accessory modules #1 an #2 since only one slot select signal will 
be active at one time. 

The slot select thereby eliminates the need for a designer of an accessory 
module to be aware of all the addresses used by other existing or future 
accessory modules. It also limits the hardware required for decoding. 

Since the accessory modules are in the 8088 address space, firmware ROMs can be 
placed on the accessory modules to be executed by the 8088. This way drivers 
for each accessory can be located in ROM on the accessory PCA and at power-on, 
when the terminal operating system does a logical system generation, the 
drivers for the modules will be used when needed for module stimulation. 

Another benefit of having the accessory modules in memory space is that block 
transfers of data between CPU and accessory module can take place quickly with 
little CPU software overhead and with the enhanced flexibility of the memory 
access instruction set of the 8088 over the I/O instructions. Thus, a 
softcard CPU can be added cleanly to the system without the hardware and 
particularly the processor intercommunication path hampering performance. 

To summarize, if a memory address between 090000H - 09FFFFH is generated by 
the CPU, HSL0TSEL1 is asserted. If an address between 0A0000H - OAFFFFH is 
generated, NSL0TSEL2 is asserted. These signals are routed to the accessory 
slots with NSL0TSEL1 going to one accessory slot and NSL0TSEL2 going to the 
other . 


CMOS RAM 

256 nybbles of battery backed up CMOS RAM is located at address 0BC000H 
OBFFFFH. The 32K address space allocated to CMOS RAM images the 256 nybbles 
found at 0BC000H - OBCOFFH. The nybble wide data is accessed on the lower 
four bits of the data bus. 
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CMOS DECODING AND ACCESS. Interfacing the CMOS RAM to the system required 
circuitry to accommodate some of the unusual address and data setup and hold 
timing parameters associated with the part. An address generated by the 
processor within CMOS memory space causes decoding circuitry to assert a CMOS 
address space select signal. When this signal is asserted, the processor PCA 
wait state generation circuitry adds 6 clock periods to the bus cycle. 


CMOS POWER. The power delivered to the CMOS comes from the same power source 
as that used for the real time clock. The Vcc pin for the chip is maintained 
at approximately 5 volts when power is applied to the system and falls to about 
2.5 volts when the power is turned off. 


LEDs 

Six LEDs are positioned on the memory PCA to report power-on test results. 
The LEDs are memory mapped at 0B8000H - OBBFFFH. Any memory write within 
this range will access the LEDs. The LEDs are accessed on the lower six bits 
of the data bus. 


LED DECODING. When the LED address is present, a memory write cycle is 
in progress, and when GO is deasserted, the LED register will be clocked with 
data from the CPU. The LEDs will in turn display the complement of the 
register contents (i.e., a "zero" turns an LED on, a "one" turns an LED off). 


LED REGISTER RESET. When the power is turned on or the NRESET test point 
on the processor PCA is grounded, the system reset signal will reset the LED 
register, making all outputs go to the zero state. This will turn all the 
LEDs on and will indicate to the observer that +5 volts is functioning at least 
well enough to light the LEDs. The self -test code will then proceed to turn 
off the LEDs if the system tests pass; or writes an error code into the 
LEDs signifying the failing subsystem or component. 


Dynamic RAM 

The 256 K of dynamic RAM requires a considerable amount of support circuitry. 
This section will describe the decoding, control signal generation, and RAM 
timing. The next section will cover the refresh mechanism used on this PCA. 
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DECODING. The 256K of RAM is organized as four hanks of 64K. The memory 
space allocation is: 


Bank 0 
Bank 1 
Bank 2 
Bank 3 


0000 OH - OFFFFH 
10000H - 1FFFFH 
20000H - 2FFFFH 
30000H - 3FFFFH 


(U42 - 049) 
(U32 - U39) 
(U22 - U29) 
(U12 - U19) 


When a memory cycle is initiated by the 8088 (BI0/-M is low) and am address 
within one of the four memory regions listed above is generated, a 3 - to-8 line 
decoder asserts one of four outputs designated for RAM bank selection. 
When GO becomes valid at the beginning of T2, the RAS inputs to the selcted RAM 
bank will all go low. 


DYNAMIC RAM REFRESH. In order to retain the data that has been written into 
a dynamic RAM, a periodic refresh cycle must occur. The refresh cycle 
consists of placing a row address on the address input pins of the dynamic 
RAM (DRAM) and then bringing the RAS input low for a specified amount of time 
and then raising it back high. Each row address within the RAM must be 
refreshed as described within a time period specified by the RAM manufacturer 
in order for the data to be retained in the RAM. This memory PCA uses a 
dynamic RAM which requires each of its 128 row addresses to be refreshed no less 
than every 2 milliseconds. This specification is typical for most DRAMs. Some 
DRAMs have 256 row addresses and require all row addresses to be refreshed no 
less than every 4 msec. The refresh controller on this memory PCA is capable of 
meeting the requirements of both types of DRAM. 

The refresh scheme used on this PCA refreshes 4 row addresses every 56 usee. 
Thus, all the rows are refreshed within 1.8 msec The entire refresh process 
takes about 2.5 usee including latencies due to the synchronizing flip-flops. 
Therefore, the refresh process consumes about (2.5 usec/56 usee) x 100% = 4.6% 
of the system bandwidth. 


PCA CONFIGURATION. Normally, this PCA will be shipped with 256 K of DRAM. 
This requires jumper W3 to be installed. If this PCA is configured with only 
128K of DRAM jumpers W1 and W2 should be installed and jumper W3 should not 
be installed. This will allow this PCA to function properly as a 128K RAM PCA 
with banks 0 and 1 of RAM installed and allows an extended memory PCA in an 
accessory slot to have a contiguous mapping of its RAM with the RAM on this PCA 
starting at memory address 20000H. 
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ACCESSORIES SUBSYSTEM 
Accessory Hardware Design Guidelines 

The two accessory slots in the card cage provide the means of increasing the 
overall system capability by adding hardware to meet needs specific to that of 
certain users. The following paragraphs provide guidelines and specifications 
needed by designers to interface with the system hardware. 


Mechanical Specifications 

The accessory PCA electrically interfaces to the system through a 70 pin 
connector located at the front of the board. The PCA can be of the type that 
fits within the card cage such as the Expansion Memory PCAs . Or it may be of 
the type which requires interfacing to external devices and requires a special 
rear panel to accomodate a connector or connectors. 

Mechanical drawings for the accessory card slots and rear panel are included in 
this section. 


Power Requirements 


Each of the two accessory slots have the following available power: 


VOLTAGE 


CURRENT 


+5V 1.9A 

+12V 0 . 45A 

-12V 0.1A 


If powering an external device through the power supply, the designer must use 
a filtering network and fuse between the external device and the HP 100 Series 
Personal Computer. Note that the power consumed by an accessory is limited by 
thermal considerations described next. 
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Thermal Limits 

The maximum thermal dissipation allowed per accessory board is 10 watts. If 
there is an accessory device consuming 10W power in one slot and your board is 
to go in the other, you should expect temperatures on your accessory board of 
20 to 30 degrees C above ambient if your board consumes 5W. If your board 
consumes 8 . 5 W, you should expect to see a 20 to 40 degrees C temperature rise 
above ambient on your accessory board. It is best to measure the case 
temperatures of components on the accessory board if one wants to verify the 
operating temperature of a particular device is within the manufacturer’s 
specifications . 


Accessory Signal Loading Restrictions 

The accessory boards have access to the signals listed in the front plane 
accessory slot pinout detail (table 3"5)« Proper adherence to the AC and DC 
loading restrictions are required for per specification performance of the 
system. Table 3 _ 3 lists the loading restrictions per accessory PCA. 
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Table 3 - 3» Accessory Loading Restrictions 

Signal 

Available 

Available 

Maximum 


Source 

Sink 

Capacitive 


Current 

Current 

Loading**** 

FPA 0-7, 12-19 
ABUS 8-11 

800 uA 

3.5 mA 

35 PF 

FPD 0-7 

800 uA 

3-5 mA 

35 pF 

BI0/-M* 

FPNRD, FPNWRT 
FPNSSO , FPDT/-R 
FPCLK, FPGO 

800 uA 

3.5 mA 

25 pF 

NSLOTSEL n 

500 uA 

5.0 mA 

25 PF 

FPNRST 

800 uA 

5.0 mA 

50 pF 

NPFAIL 

500 uA 

2.0 mA 

25 pF 

BATV 

kO uA 

0 

— 

SHOLDA 

250 uA 

5.0 mA 

25 pF 

FULLMEM** 

0 

10 mA 

--- 

NOCINT*** 

NDCOCINT 

NOCWAIT 






NOTE 

1 


# The BXO/-M signal comes from one driver and is found 
on pins U7 and 62 of the connector. The aggregate of 
the loading on the two pins must not exceed the 
specification in the table. 

** FULLMEM , if used, must be pulled high by a pullup 
resistor on the accessory board. 

These signals must be driven by an open collector 
driver. The pullup resistor is on the processor board 
and need not be on the option board. NOCWAIT 
requires a driver capable of sinking 18 mA (Schottky 
driver) . The NOCINT and MDCOCINT drivers must be 
capable of sinking 5 mA. 

***** fp 0 es timate capacitive loading, one can use 2 pF 
per connector pin, 5 pF/inch of PC trace, and 5~10 pF 
per gate terminal. 
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Signal Timing Diagrams 

Timing diagrams in figures 3~19 thru 3 "21 are based on a system with two 
accessory boards installed which conform to the loading restrictions stated in 
the previous paragraph. 

Table 3~^* Accessory Slot Timing Characteristics* 


Symbol 

Parameter Norn . 

Min. 

Max 

Tab 

Clock high time 

k3 


Tbc 

Tac 

Clock low time 

Clock period 125 

68 


Tal, Tbm 

FPCLK to 8088 clock skew 


28 

Tan 

BI0/-M delay from clock rising 
edge 

Ik 

88 

Tao 

FPNSSO delay from clock rising 
edge 

Ik 

83 

Tbp 

FPA n delay from T1 beginning 


102 

Tbq 

ABUS n delay from T1 beginning 


95 

Tkr 

ABUS hold time from Tk rising 
edge 

10 


Tbs 

NSLOTSEL delay from T1 beginning 


110 

Tdt 

FPGO delay from T2 beginning 


k8 

Tju 

FPGO delay from Tk beginning 


k8 

Tdv 

FPNRD delay from T2 beginning 

Ik 

128 

Tjw 

FPNRD delay from Tk beginning 

lk 

108 

Tvw 

FPNRD width 

325 


Txj 

Read data setup time 

k9 


Tjy 

Read data hold time 

10 

225 

Taz 

FPDT/-R delay from clock rising 
edge 

lk 

83 

TkAA 

FPDT/-R deJ.ay from clock rising 
edge 

lk 

83 

TdBB 

FPNWRT delay from T2 beginning 

lk 

98 

TjCC 

FPNWRT delay from Tk beginning 

lk 

98 

TBBCC 

FPNWRT width 

335 


TdDD 

Data valid delay from T2 
beginning 


8k 

TkEE 

Data hold time from rising 
edge of Tk 

10 


TuEE 

Data hold time from FPGO 
deassertion 

30 


TFFHH, 

TGGII 

SHOLDA delay from falling 
edge of clock 


2k 

THHII 

SHOLDA width (in usee) 2.5 

2.25 

2.63 

TLLJJ, 

TMMKK 

NOCWAIT setup time before 
falling edge of clock 

13 

ko 

TLLHM 

NOCWAIT width (in usee) 0.125 



*A11 time specifications are in nsec unless stated otherwise. 
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Figure 3~19- Accessory Slot Bu3 Cycle Timing 
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Accessory Front Plane Connector 

The accessory PCAs plug into the bottom slots of the card cage. The system 
signals available to the modules are listed in table 3“5> 


Table 3~5 • Connector Pinouts 


1 . 

FPA 0 

26 . 

FPD 3 

51. 

GND 

2. 

FPA 1 

27. 

FPD 4 

52. 

-12V 

3- 

FPA 2 

28. 

FPD 5 

53. 

SHOLDA 

4. 

FPA 3 

29. 

FPD 6 

54. 

FPGO 

5. 

FPA 4 

30. 

FPD 7 

55. 

+5V 

6. 

FPA 5 

31. 

GND 

56. 

GND 

7. 

FPA 6 

32. 

FPNRD 

57. 

FPCLK 

8. 

FPA 7 

33. 

GND 

58. 

(RESERVED) * 

9. 

ABUS 8 

34. 

+5V 

59* 

GND / FULLMEM * 

10. 

ABUS 9 

35- 

BATV 

6o. 

+12V 

11. 

ABUS 10 

36. 

(RESERVED) * 

6l. 

GND 

12. 

ABUS 11 

37. 

NPFAIL 

62 . 

BI0/-M 

13. 

FPA 12 

38. 

(RESERVED) * 

63. 

+12V 

14. 

FPA 13 

39- 

FPNRST 

64. 

FPNWRT 

15. 

FPA 14 

40. 

+5V 

65- 

+5V 

16 . 

FPA 15 

41. 

GND 

66. 

FPDT/-R 

17. 

FPA 16 

42. 

GND 

67. 

GND 

18. 

FPA 17 

43. 

NOCINT 

68. 

FPNSS0 

19. 

FPA 18 

44. 

GND 

69 . 

GND 

20. 

FPA 19 

45- 

NOCWAIT 

70. 

NSLOTSELx ## 

21. 

GND 

46. 

(RESERVED) * 



22. 

GND 

47- 

BI0/-M 



23. 

FPD 0 

48. 

+5V 



24. 

FPD 1 

49- 

-12V 



25. 

FPD 2 

50. 

NDCOCINT 



4 . _ _ 


JF3 

and JF4 




35 I + + . . . . . . + + | 1 

70 j + + ... . .. + + j 36 

+ + 


Pictorial view of option module front plane connectors ( JF3 and 
JFU) with pin assignment (as viewed from component side of Front 
Plane PCA) . 

* Pin 59 is FULLMEM is on JF3 only. Pin 59 is GND on JF4. 
Connections to this pin and all pins labeled RESERVED should 
not be made. 

# * NSLOTSELx will be either NSL0TSEL1 or NSL0TSEL2 depending 
upon which side of the front plane the module is plugged 
into. The left side of the card cage (from rear view of the 
package) holds module 1 and gets the NSL0TSEL1 signal. The 
right side of the card cage holds module 2 and gets 
NSL0TSEL2 . 


3-70 



Hardware Subsystems 


Accessory Connector Signal Descriptions 

The accessory connector signals described in table 3-6 reference the timing 
diagrams in figures 3 _ 19 through 3 _ 21. 

Table 3-6. Signal Descriptions 


FPA 0-7 The lower 8 address bits of the 20 bit address generated by 

the 8088. These signals are buffered and demultiplexed. 

ABUS 8-11 The upper 12 address bits of the 20 bit address. 

FPA 12-19 These signals also are buffered and demultiplexed. 


FPD 0-7 

FPCLK 

FPNRD 

FPNWRT 

FPNSSO 

BI0/-M 

FFDT/-R 


Data bus signals from the external data bus. This data path is 
the means through which data is passed between the processor 
and the video board or option slot modules or the optional TPM. 

Buffered 8 Mhz system clock. 

Buffered -RD signal from the 8088 used to indicate a bus 
read cycle in progress. 

Buffered -WRT signal from the 8088 used to indicate a bus 
write cycle in progress. 

8088 bus cycle status line. The combination of FPNSSO, 
BI0/-M, and FPDT/-R allow boards connected to the front plane to 
completely decode the current bus cycle. 

Buffered 10/ -M signal from the 8088 used to distinguish 
memory and I/O bus cycles. 

Buffered DT/-R signal from the 8088 used to indicate 

direction of data from the 8088 for a given bus cycle. 


FPGO Signal which qualifies the address generated by the 

microprocessor. The address qualification is needed primarily 
for dynamic RAM circuits which cannot tolerate an assertion of 
RAS or CAS on a false address. FPGO goes high at the 

beginning of T2 and goes back low at the beginning of TU of a 
bus cycle. FPGO can also be used to terminate a bus write 
cycle by having its falling edge used to clock data into a 
register or other device on an accessory device in an option 
slot. Terminating the writes in this way can provide better 
hold timing than using FPNWRT. 
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NOCWAIT 

NDCOCINT 

NOCINT 

SHOLDA 

FULLMEM 

NSLOTSEL1 

NSLOTSEL2 

FFHRST 

HPFAIL 

BATV 


This line can be asserted by the option modules or video 
board through an open collector gate to insert wait states into 
a bus cycle to provide sufficient time for a bus cycle access. 

This open collector interrupt signal has the same interrupt 
priority as the datacomm controller chip on the processor 

board as it shares the same input to the interrupt controller as 
the datacomm controller chip does. This input can be asserted 
by accessories for interrupt servicing. 

System interrupt signal asserted by a device via an open 
collector gate. This line earn be used by options slots to get 
processor service. 

Synchronized hold acknowledge signal from the 8088. HOLD 
is asserted by the mezzanine memory board. 

Indicates which mezzanine memory board option is installed. 

FULLMEM=0 if 128K RAH and FULLMEM =1 (it is pulled high by a 

pull up resistor on an installed extension memory board) if 

256 K RAM is on the board. An accessory should not connect to 
this signal pin. 

Signal indicating an address within the 6 UK block allocated to 
option module 1 has been generated by the 8088 . 

Same as NSL0TSEL1 but asserted when address within option module 
2 address space is generated. 

Signal generated by processor board at power-on time to 
initialize logic circuitry. 

Signal generated by the power supply indicating power supply 
output level stability. 


These two connector lines carry current from the batteries 
located on the video board to circuitry requiring battery 
back-up power such as the CMOS RAM and the CMOS real time 
clock. 
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ACCESSORY CARD HARDWARE AND ELECTRICAL 


Electrical Design 


HELPFUL DESIGN HINTS. Because the 8088 in the HP 150 runs in "Min" mode, the 
write line (FPNWR) may not rise soon enough to lock your data in. The signal 
FPGO is designed to allow this timing deficiency to be overcome. One way this 
may be implemented is by combining DT/-R with FPGO to create a write signal. 
The sample schematic (figure 3-31) at the end of this section shows a typical 
method of doing this. 

Note that the signal NSLOTSEL is not guaranteed to be valid until 110 ns into 
the "Tl" cycle. Prior to that time, glitches may be present. Edge sensitive 
chips should not be directly connected to this line. In general, NSLOTSEL 
should be combined with another of the control lines to create a valid signal. 
Note ho^r NSLOTSEL is combined with FPGO on the sample schematic to create the 
signal NQUAL which is low only when the board is truely selected. 

Based on the two points above, you have probably noticed what a handy little 
signal FPGO can be. FPGO is the first signal you should turn to if you come up 
with any timing problems in the interface to the HP 150 bus. 

The HP 150 firmware has provisions to deal with options cards. To take full 
advantage of these features, an option card should provide an "ID BYTE" at the 
first address in the memory space. In the sample schematic enclosed, the "ID 
BYTE" has been loaded into the first address of the ROM. If a ROM is not 
present on the accessory card, an "ID Byte" may be generated via an octal buffer 
(like a LS244). Use a dip switch to set the "ID BYTE" in this case. 

Be aware of the capacitive and dc loading specifications that am accessory card 
must meet. It doesn’t take too many gates and trace lengths to exceed the 
specifications. Note, for example, that most control lines will not drive two 
Schottky gates because there would be a violation of the DC loading 
specification. The DC and AC loading specifications are contained in table 3“3* 


GENERAL SCHEMATIC DISCUSSION. There is a "generic" accessory card schematic 
in figure 3“31* It includes a tranceiver interface to the data bus, buffering 
of the address lines, buffering and filtering of the reset line, memory and I/O 
space accesses, and a ROM. The memory and address reads are separated with the 
BI0/-M signal. When high, this signal disables the S138. The S138 determines 
which of the the main blocks on the accessory card are selected. If an I/O 
access occurs to the address set by the dip switches, then the state of the Fj4 
flip flop is toggled. This will select one of the two LEDs. The "controller" 
is a piece of LSI logic which takes care of the external peripheral device. 
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Another feature that is nice to have, although not present on the enclosed 
schematic, is a software hard reset of the accessory card. This allows the card 
to be hard reset without a hard reset of the system. 


TRANSCEIVER SCHEMATIC DISCUSSION. The schematic in figure 3-22 includes a 
tranceiver on the data bus. This circuit illustrates how a "general purpose" 
trance iver might be put on the data bus. 

There are a number of problems in putting a tranceiver on the data bus 
including: 

1. Creating a write pulse which will clock data into its destination and allow 
sufficient hold time before the tranceiver is disabled. 

2. Ensuring that the tranceiver is not disabled prior to the data hold time on 
a read. 

3. Ensuring that the tranceiver is disabled prior to DT/-R changing state. 

The circuit proposed should solve these problems without causing contention on 
the HP 150’s data bus or on the accessory card’s data bus. In addition, it does 
not rely on unspecified minimum delay times. Check the timing to see if this 
circuit will work for a particular application. 

The circuit works by first latching (with the rising edge of FPCLK) a board 
select signal (NQUAL) as the tranceiver enable signal. This delays the 
tranceiver enable signal, allowing read/write cycles to finish prior to 
disabling the tranceiver. 

Since the tranceiver enable signal has been delayed, DT/-R must also be delayed. 
The second flip-flop latches the state of DT/-R with the falling edge of FPCLK. 
This delay allows the tranceiver to be disabled prior to a direction change (at 
the end of an instruction cycle) while still allowing the direction to be 
established prior to tranceiver enable (at the start of an instruction cycle). 

Of course, the circuits above will not be useful for every design but they may 
be helpful in saving a little time in the design process. Remember that the 
ultimate responsibility is yours. 

Parts List 

1 FAST ’00 
1 FAST ’74 
1 ALS ’245 
1 LS ’04 
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DC Loading (For Tranceiver Circuit Only) 


FPDT/-R 

hO uA High 
1.2 diA Low 

FPGO 

40 uA High 
1.2 mA Low 

FPCLK 

hO uA High 
1.0 mA Low 

NSLOTSEL 

20 uA High 
.4 mA Low 

References 


1982 Past Data Book (Fairchild) 

1981 TTL Data Book (Texas Instruments) 

1983 ALS/AS Data Book (Texas Instruments) 


fpnrd 
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Mechanical Design 

HELPFUL DESIGN HINTS. Consider the height restriction drawing since the tabs 
where the I/O panel thumbs crews attach caui interfere with components on the 
accessory card. 

The I/O Panel should be of a sturdy design so it will transfer sufficient force 
to cause the frontplane connector to seat. When testing the mechanical design, 
remove the metal chassis and watch the connector as the thumbs crews are 
tightened. It is possible to design a panel such that the thumbscrews will go 
all the way in, yet the frontplane connector will not move. 

Hake sure that the I/O panel has as many holes for airflow as possible. The air 
will flow along the long dimension of the accessory board. For mo3t effective 
use of this airflow, lay the chips out with their long dimension perpendicular 
to this airflow. Also, lay your "hot" chips as close to the I/O panel as 
possible. 

Be sure to mask off the annular ring around the thumbscrew’s hole and to use an 
inside star washer between the thumbscrew and the I/O panel. This will ensure 
that there is a solid ground path between the I/O panel and the chassis of the 
HP 150. 

I/O Panels with a connector should have the ground plane split near the I/O 
panel to bypass the connector shield to the I/O Panel ground. This will prevent 
high frequency noise (like ESD) from entering the system. 


I/O PANEL DESIGN. Accessory cards not requiring an I/O Panel should be based 
on the board blank drawing titled "Board Blank - no I/O Panel" with two 
extractors and two extractor retainer pins to remove the accessory card from the 
HP 150. Drawings for the extractors as well as the extractor retainer pins are 
provided in this manual. 

If an I/O panel is required, all the required dimensions may be obtained from 
the drawings enclosed. Please note that the accessory card fits under the 
L-bracket for the design presented. The I/O Paine 1 should foe solid and sturdy 
since the force from the thumbscrews must foe tramsmitted to the frontplane 
connector in order to fully insert the connector. 
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LIST OF VENDORS 


CAUTION 


Parts may be available from the following vendors. HP 
does not guarantee or warrant any of the following parts 
or vendors. 


o Frontplane Connector 

Vendor: Amp 

Harrisburg, Pa. 

Vendor Part Number: 1-102584-0 

o Thumbscrew 

Vendor: Precision Metal 

3402 Enterprise Ave. 

Hayward, Ca 9^5^5 
(415) 887-1401 

Vendor Part Number: 45641-00001-2 (also HP Part No.) 


Use the drawing in figure 3 - 24 to set this part up with its own part number. 
This will prevent any possible changes to the part from affecting you. The 
drawing will also allow the part to be set up with any vendor you wish. 


o E-Ring Retainer 

Vendor: Truarc Retaining Rings Division 
Waldes Kohinoor, Inc. 

47-16 Austel Place 
Long Island City, NY 11101 
(212) 392-3100 

Contact the factory for the distributor near you. 
Vendor part number: Truarc X-5133-11 H. 
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o L -Bracket 

Vendor: Pike Tool and Grinding Inc. 

1*205 High Country Road 
Colorado Springs, Colo. 80907 
(303) 598-9611 

Vendor Part Number: 45641-00001-1 (also HP Part No.) 

Use the drawing in figure 3-25 to set this part up with its own part number. 
This will prevent any possible changes to the part from affecting you. Again, 
the drawing is provided for this part if you wish to set it up yourself. 


o Accessory Card Extractor (figure 3~26) 

Vendor: Trend Plastic 

1245 Laurelwood Rd. 

Santa Clara, CA. 95050 
(408) 727-5797 

Vendor Part Number: 0403-0h73 (also HP Part No.) 


o Accessory Card Extractor Retainer Pin (figure 3 -27) 

Vendor: Drivelock, Inc. 

Sycamore , IL . 

(815) 895-8161 

Vendor Part Number : 9945 

One possible distributor for this part is: 

Bearing Engineers, Inc. 

1250 Space Park Way 
Mountain View, CA. 94040 

(415) 969-1155 

The Bearing part number is 3-0.33Q-R-SP. 


I/O PANEL PAINT SPECIFICATIONS 
Scope 

This specification establishes the requirements for pigment composition, to 
achieve a color in HP’s Corporate Color Program. 
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Requirements 

o Pigments used to manufacture a color should be from the 
approved Hewlett-Packard List, "Pigments Used to Achieve 
the Corporate Color" . 

o Pigment substitutes may be required for specific type of 
material that uses higher temperature, (such as plastic) 
to be produced in a Corporate Color. 

a. Use pigment with equivalent physical and performance 
properties as recommended on the pigment list. 

b. Required physical and performance properties of pigments 

1. Heat Resistance 

2. Bleeding Characteristics 

3. Chemical Resistance 

4. Exposure Performance (Ultra-violet , etc „ ) 


Quantitative 

o Pigment Composition (approximation - adjust % for tinting 
purposes) 

a. Paint Pigments for Parchment White Case, Visual Color 
Standard No. 6009-0130: 

Trac e % Lampblack 
18.55 % Titanium Dioxide White 
.31 % Yellow Iron Oxide 
Trace % Red Iron Oxide 

* 

Gloss Standard: 18+-3 Gloss Units at 85 degree /- 

b. Paint Pigments for Cobblestone Gray Accent, Visual Color 
Standard No. 6009-0133: 


8.0 

A 

Lampblack 

28 U 

A 

Titanium Dioxide White 

10.9 

A 

Yellow Iron Oxide 

I4.5 

A 

Red Iron Oxide 

1+8.3 

% 

Other 


Gloss Standard : 18+-3 Gloss Units at 85 degree /- 
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Drawings 

Included in this section are the following drawings: 
o I/O Panel 
o Retainer Thumbscrew 
o L -Bracket 

o Accessory Card Extractor 
o Accessory Card Extractor Pin 

o Board Blank With I/O Panel (Accessory Card Details) 
o Height Restriction (Accessory Card Clearances) 
o Board Blank - No I/O Panel 
o Accessory Card Schematic 
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Figure 3 - 23 * I/O Panel 



iOTES 

1. FINISH: SRiMD TO DEBURR. ZINC CHRQMRTE CQMVERSIQIM 

.oosnn thick . 

E. RIVET ITEM 7 TO ITEM 1 MITH ITEM 8 12 FLOS . 3) 
i. MRSK OFF TWO RISERS OF iMM OIR. RT THE THO 3.S DIR. 

HOLES RMD SFRRY PRINT THE FRONT SIDE RND EDGES OF ITEM 1. 
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0.46 


+ .05 
-.00 


Figure 3-24. 


1. FINISH: SAND TO DEBURR. 

ZINC CHROMATE . 0.005 HM THICK 

2. ITEM 2 INSTALLED AS SHOHN . 

USE PEM SELF-CLINCHING 
FASTENER OR EQUIVALENT. 


Retainer Thumbscrew 





1.53 R 



<$— 9.5 — P 

A^ 

IS 

.3 

4 A 

47s 

r\^ 

1.6 



1 

c 

) 

V 


V 

, r 

— > 


J ^ 

4.7 

<k- 



A 




.17.00. 

(REF) 


-$> 


A 


15.00 




4.25 DIA. (+.08-.00) 
28.85 


FOLD UP 90 DEGREES 
3.20 DIA (+. 003- .000) 2 PLCS. 





f 

M3 - PEfA rvjUT 


1 

tlB 

COLD ROLLED STEEL .07+TH 



Figure 3~25- L-Bracket 
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COMPONENT SIDE VIEW 


NOTES : 

Q] NO COMPONENTS ALLOWED IN THIS AREA . 
ID COMPONENTS HIGH 9.2 MM MAX. 

0 COMPONENTS HIGH 17.5 MM MAX. 

4. ALL DIMENSIONS IN MILLIMETERS. 


Figure 3~29* Height Restriction Drawing (Accessory Card Clearances) 
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MEMORY AND I/O MAPPING 


SECTION 


4 


This section contains memory and input/output maps for the HP 150 memory and 
input/output address spaces. Included is information describing the register 
and bit mappings of all devices which consume a portion of the 8088 processor’s 
address space for both memory and input /output instruction types. More 
information regarding the functionality of the devices themselves may be found 
in Section 3 , Hardware Subsystems. 
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MEMORY MAPPED DEVICES 
HP 150 Memory Map 


FOOOO 

EOOOO 

DUOOO 

D3000 

DOOOO 

C8000 

coooo 

BC100 

BCOOO 

B8001 

B8000 

BOOOO 


+ 

I 

+ 

I 

+ 

I 

+ 

I 

+ 

I 

+ 

I 

+ 

I 

+ 

I 

+ 

I 

+ 

I 

+ 

I 

+ 

+ 


Firmware 

ROM 

(128 K) 


RESERVED (Alpha RAM/CRTC Image) 


CRT Controller Registers / VATT Latch 


Alphanumeric Character RAM (12 K) 


RESERVED (Graphics RAM Image) 


32K Graphics RAM 


RESERVED (CMOS RAM Image) 


256 x 4 CMOS (Configuration) RAM 


RESERVED (System Status LEDs Image) 


System Status LEDs 


+ 


+ 




+ 


+ 


+ 


+ 


+ 


+ 


+ 


+ 


-h 


continued on 
next page 
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HP 150 Memory Map continued 


B0000 

aUooo 

AOOOO 

94000 

90000 

80000 

70000 

60000 

50000 

40000 

30000 

20000 

10000 

06000 

00000 


RESERVED FOR FUTURE ACCESSORY 

SLOTS 

Accessory Slot 2 Address Space 

(16K) 

RESERVED FOR FUTURE ACCESSORY 

SLOTS 

Accessory Slot 1 Address Space (l6K) 

ROM Expans ion / | \ 

1 1 

1 1 


1 i 

1 1 

\l/ 1 

1 

— 

RAM Expansion 


Operating System 

and User RAM 

— 

(Standard, 232 K) 

— 

Firmware RAM / Op . Sys • Interrupt Vector RAM 


-+ 

I 

-+ 

I 

"f 

I 

-+ 

I 

-+ 

I 

-+ 

I 

-+ 

I 

-+ 

I 

-+ 

I 

-+ 

I 

+ 

I 

+ 


/l\ 

I 

I 

I 


NOTE 


Used for 
RAM in 
640 K Byte 
config. 


For a more detailed map of Operating System, User, and Firmware RAM useage, 
refer to System Software (Section 5)» Operating System Memory Map. 
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CRT Controller Registers 

Register Bit Definition 

Type 

D7 D 6 D5 D4 D3 D2 D1 DO 


+ + + + + + + + + 


MSB 

CHARS. /HORIZONTAL PERIOD 

LSB 

MSB 

CHARACTERS/ DATA ROW 

LSB 

MSB 

HORIZONTAL 

DELAY 

LSB 

MSB 

HORIZONTAL SYNC WIDTH 

LSB 

MSB 

VERTICAL SYNC WIDTH 

LSB 

MSB 


VERTICAL 

DELAY 

LSB 

PIN CONFG CURSOR SKEW | BLANK SKEW | 

|MSB 

VISIBLE DATA ROWS/ FRAME 

LSB | 

|SCAN LINES/FRMl SCAN LINES /DATA ROW | 

(BIO 


(Ml 

(MSB) 

(LSB) 

(B7) 

SCAN LINES / 

FRAME 

[M. 

DMA 

IMA BURST 

DLY 

DMA BURST COUNT 1 

DIS 






ABLE 

MSB 



LSB 

MSB | 

LSB 

X 

PB/ 

| INTERLACE 

OPERATION 

2XC/ 


SS 

MODES 

MODES 

1XC 

MSB 

TABLE START REGISTER (LS BYTE) 

LSB 

| ADDRESS 

| TABLE START REG (MS BYTE) 

| MODE 

(MSB) 

(LSB) | 

MSB 

AUX. 

ADDRESS REG.l (LS BYTE) | 

LSB 

| ROW 

AUX ADDR REG 1(MS BYTE) 


| ATTR’S 

(MSB) 


(LSB) 

MSB 

SEQUENTIAL BREAK REG. 1 j 

LSB 

MSB 

DATA ROW 

START REGISTER 

LSB 

MSB 

DATA ROW END/SEQU. BRK REG 2 

LSB 

MSB 

AUX. ADDRESS REG. 2 (LS BYTE) 

LSB 

| ROW 

AUX ADDRESS REG 2 (MS BYTE) | 

| ATTR’S 

(MSB) 

(LSB)! 


START 

COMMAND 



RESET 

COMMAND 


|OFST| 





| OVR- 


OFFSET 

VALUE 


| FLOW | (MSB) 


(LSB) 

0 

| VERTICAL 

CURSOR REGISTER (ROW COORD. ) | 

j (MSB) 



(LSB) | 

| HORIZONTAL CURSOR REG. (COL. COORD.) | 

(MSB) 




(LSB) | 


VERT 

INTERRUPT ENABLE REG | 

FRM| 


RE- 

LGHT 



TIM-1 

X 

TRCE 

PEN 

x I 

X | X | X | 

ER | 

INT 

VERT 


STATUS REGISTER | 

PEN- 

RE- 

LGHT 


1 ODD/ 1 1 

FRM 

DING 

TRCE 

PEN 


|EVEN| X | 

TMER 

MSB 

VERT LIGHT PEN REG (ROW COORD) | 

LSB 

MSB 

HOR LIGHT 

PEN REG (COL COORD) 

LSB 




VIDEO ATTRIBUTES REGISTR | 



|DISP | 

| CURS | | 

1 

X 

X 

X 

ON | 

BLRT | BLRT j BLOB 

GREN| 


Initialization 

Register 


Regis- 

Data 

8088-Addr 

ter # 

(hex) 

(hex) 

Read /Write 

RO 

# 

73 

D3000 

WRITE 

R1 

# 

*4F 

D3002 

WRITE 

R2 

# 

2E 

D3004 

WRITE 

R3 

# 

07 

D3006 

WRITE 

R4 

# 

13 

D3008 

WRITE 

R5 

# 

20 

D300A 

WRITE 

R6 

# 

C9 

D300C 

WRITE 

R7 

# 

*1A 

D300E 

WRITE 



# 



R8 

# 

2D 

D3010 

WRITE 

R9 

# 

9F 

D3012 

WRITE 

RA 

# 

70 

D3014 

WRITE 

RB 

# 

4l 

D3016 

WRITE 

RC 

# 

91 

D3018 

WRITE 

RD 

# 

97 

D301A 

WRITE 

RE 

# 

FF 

D301C 

WRITE 

RF 

# 

3F 

D301E 

WRITE 

RIO 

+ 

FF 

D3020 

WRITE 

Rll 


FF 

D3022 

WRITE 

R12 


FF 

D3024 

WRITE 

R13 

+ 

00 

D3026 

WRITE 

Rl4 

+ 

00 

D3028 

WRITE 

R15 


00 

D302A 

READ/WRITE 

Rl6 

+ 

00 

D302C 

READ/WRITE 

R17 


00 

D302E 

WRITE 

Rl8 


FF 

D3030 

WRITE 

R38 


-- 

D3070 

READ 

R19 


00 

D3032 

WRITE 

R39 



D3072 

READ 

R1A # 

4o 

D3034 

WRITE 

R3A 


-- 

D3074 

READ 

R3B 

+ 


D3076 

READ 

R3C 

4 - 


D3078 

READ 

"VATT" 

00 

D30BE 

WRITE 
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* These registers are programmed with N -1. 

# These registers must have these initialization values. 

+ These registers may not be accessible on future HP 150 revisions 
and must not be written to or read from. 


NOTE 


For a full description of the CRT Controller registers, refer to the 
SMC9007 data in Standard Microsystems Corporation 1982 Data Book. Use of 
registers noted as being not accessible on future HP 150 revisions is not 
recommended and such access may result in software incompatibilities with 
certain HP 150 units. All addresses not specifically shown are reserved 
and should not be used. 


A description of CRT controller registers as those registers are used and 
supported by the HP 150 follows. 


HORIZONTAL TIMING REGISTERS (RO, Rl, R2 AND R3) 

These registers define the horizontal scan line timing. They must contain 
the (hexadecimal) values shown. 


VLT 

HOR. SYNC 


1 < one scan line 


> ! 


J < 
1 

i < 

1 

1 

+-- 


RO -> ! 

73 1 ! 

R1 J <-- (RO-Rl) --> ! 

UF ! i 

! ! <-R2-> J 

! 2E 

+ j 4- 


! ACTIVE DISPLAY J 1 

+ + 


+ *5“ — — — — — f- 

I I R3 > | 

+ + 07 + 


4-U 




Memory and I/O Mapping 


VERTICAL TIMING REGISTERS (R4, R5, R7, R8 AND R9) 

These registers define the vertical frame timing. They must contain the 
(hexadecimal) values shown. 


< one complete frame > J 

< R9 ___> I 

9F ! ! 

< (R7xR8) > l ! 

1A 2D ! ! 

! ! <-R5-> ! 

! 20 


VERTICAL BLANKING 
(NO SKEW) 

+ +-- 

1 DATA ROW DISPLAY TIME1 
+ ~ + 

. JL 

+ 

! ! 

! + 

! 

m&mmmmm — — mm — — — mm . 

VERT. SYNC 

! 

+ 

! <--- R4 
--+ 13 


PIN CONFIGURATION/SKEW BITS REGISTER (R6) 

- Contains pin configuration information ( bit 7,6 ) 

- Cursor skew ( bits 5,4,3 ) define the number of character 
clocks the cursor signal is delayed from VLT 

- Blank skew ( bits 2,1,0 ) define the number of character 
clocks the horizontal blank component of the CBLANK signal 
is delayed from VLT. 

- Both cursor skew and blank skew are the value "001" for 
the 1 character skew. 

- Must contain C9 Hex. 


DMA CONTROL REGISTER (RA) 

- DMA disabi.e ( bit 7 ) • A logic "1" on this pin forces the 
SMC9007 DMA request into the inactive state, and the 
address bus will enter its high impedance state. 

- DMA burst delay (bits 6,5,** )• This register is loaded 
with "111" for zero delay, allowing all characters to be 
retreived from video RAM in one burst. 

- DMA Burst Count ( bits 3, 2, 1,0 ). Not Used. 

- Must contain 70 Hex. 
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CONTROL REGISTER (RB) 

- 7 bit register 

- Smooth scroll mechanism is enabled by writing a "1" to bit 

6 . 

- Interlace, ( bits 5,4 )♦ ”00" - non interlaced mode. 

- Operation mode ( bits 3,2,1 ). "000” for repetitive 

memory addressing. 

- Single/double height cursor ( bit 0 ). "1" = single. 

- Must contain 4l Hex. 


TABLE START REGISTER (RC AND RD) 

- These registers point to the address where the row table 
begins. 

- The registers are set up the following way for contiguous 
row table mode: 

* register D ( bits 7,6 ) = "10" 

* register D ( bits 5~0 ) = upper 6 bits of the 

14 bit address 

* register C ( bits 7-0 ) = lower 8 bits of the 14 

bit address. 

- RC must contain 91 Hex, RD must contain 97 Hex. 


AUXILIARY REGISTER 1 (RE AND RF) 

- Not used, except for bits 7,6 in register F which must be 
"00" for single height, single width characters. 

- RE must contain FF Hex, RF must contain 3FH. 


SEQUENTIAL BREAK REGISTER 1 (RIO) 

- This register may not be accessible on certain HP 150 revisions 
and must not be used. 


DATA ROW START REGISTER (Rll) 

- Defines the first data row number at which a smooth scroll 
operation begins. 

- Is initialized by the system firmware to FF Hex. 


DATA ROW END REGISTER (R12) 

- The row numerically one less than the row defined by this 
register is the last data row on which a smooth scroll 
will occur. 

- Is initialized by the system firmware to FF Hex. 
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AUXILIARY ADDRESS REGISTER 2 (R13 AND R14) 

- This register may not be accessible on certain HP 150 revisions 
and must not be used. 


START COMMAND (R15) 

- During initialization of the SMC9007, after all vital 
screen parameters are loaded, a start command can be 
initiated by addressing this dummy register location. 

RESET COMMAND (R16) 

- This register may not be accessible on certain HP 150 revisions 
and must not be used. 


SMOOTH SCROLL OFFSET REGISTER (R17) 

- This register is loaded with the scan line offset number 
to allow a smooth scroll operation to occur. The offset 
register causes the scan line counter to start at the 
programmed value rather than zero for the data row that 
starts the smooth scroll interval. 

- Must have data bit 7 (most significant) cleared (0). 

VERTICAL CURSOR REGISTER (R18) 

- This register specifies the data row in which the cursor 
appears . 

HORIZONTAL CURSOR REGISTER (R19) 

- This register specifies the character position in which 
the cursor appears . 

CURSOR REGISTERS R38 AND R39 (READ) 

- These registers may not be accessible on some revisions of the 
HP 150 and must not be used. 

INTERRUPT ENABLE REGISTER (R1A) 

- This 3 bit write only register allows each of the 3 
SMC9007 interrupts to be enabled or disabled. 

- Bit 6 is set to "1" to enable vertical retrace interrupts. 

- Must contain 40 Hex. 
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STATUS REGISTER (R3A) 

- This register is only used to clear the interrupt bit. The 
value read is irrelevent. 


VERTICAL LIGHT PEN REGISTER (R3B) 

- This register may not be accessible on certain revisions of 
the HP l^O and must not be used. 


HORIZONTAL LIGHT PEN REGISTER (R3C) 

- This register may not be accessible on certain revisions of 
the HP 150 and must not be used. 


VIDEO ATTRIBUTE LATCH 

This latch stores 5 bits of video 
blank portions of the video frame, 
the 8088 address D30BE hexadecimal, 
non-existent SMC9007 register. 


data, and can be updated during the 
It is a memory mapped I/O register with 
The register is actually decoded as a 


VIDEO ATTRIBUTE LATCH PIN DEFINITION 

+ + + + + + 

| DISPON | BLRT | CBLRT | BLOB | GREN | 

+ + + + + + 

D4 D3 D2 D1 DO 

note: - positive logic is used ( 1 = on, 0 = off ) 

- when writing to this register, D5~D7 are don’t cares 


DISPON 

BLRT 


CBLRT 


BLOB 


Alpha Display On 
Character Blink Rate 

Characters with BL ( blink ) enhancement 
set will be blanked on the screen while 
BLRT is a "1." 

Cursor Blink Rate 

The character for which CURS from the 
SMC9007 is active high, the cursor will 
be blinked when CBLRT is a "1." 

Blob Cursor Select 

(otherwise double scan line cursor) 


GREN 


Graphics Display Enable 
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I/O MAPPED DEVICES 
HP 1 50 I/O Map 

OOFF + + 

I I 

I I 

Reserved For 

| Accessory Slots | 

i i 

i i 

0080 + - — + 

j I/O Image j 

I (DO NOT USE) j 

0060 + + 

I I 

| Real Time Clock (MM58167A) | 

I I 

oo4o + + 

I I 

| Integral Printer Interface | 

0030 + + 

I I 

| Reserved | 

| (DO NOT USE) | 

001C + + 

I I 

| Keyboard/Touchscreen Controller (8o4lA) | 

0018 + - + 

| Datacoimn Port 2 Control Lines | 

| Manufacturing Test Repeat | 

0016 + + 

| Datacomm Port 1 Control Lines | 

| Datacomm Clock Source Select | 

0014 +---- + 

I I 

| Interrupt Controller (8259) I 

0010 + + 

I I 

| Baud Rate Generator (8II6T) | 

000C + + 

I I 

I I 

| HPIB Controller (9914) | 

I I 

ooo4 + + 

I I 

| MPSC - Datacomm Controller (7201) | 

0000 + + 
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Memory and I/O Mapping 


NOTE 


I/O mapped devices at 0000 Hex through 0080 Hex are not exclusively decoded 
to 16 bits. Rather they may be accessed through any combination of high 
order byte bits. For future hardware compatibility it is highly 
recommended that programs which access I/O mapped devices directly at these 
addresses do so with a high order byte address of 00 Hex. Accessory cards 
may exclusively decode a 16 bit address. See the accessory card 
specifications for more information. 


Real Time Clock (MM58167A) 


Address 

- + 

| Register 

+ 

1 Type 

0056-005FH| Not Used 

| reserved 

0055H 

| "GO" Comamand Register 

| write 

0054H 

j Status Bit 

| read 

0053H 

| RAM Register Reset 

| write 

0052H 

| Counter Register Reset 

| write 

0051H 

| Interrupt Control Register 

| write 

0050H 

| Interrupt Status Register 

| read 

OOhFH 

j Month RAM Register 

| read/write 

ooUeh 

j Date RAM Register 

| read/write 

oo4dh 

j Day RAM Register 

| read/write 

004CH 

j Hour RAM Register 

| read/write 

004BH 

j Minutes RAM Register 

| read/write 

oo4ah 

| Seconds RAM Register 

| read/write 

00U9H 

j Tenth/Hundreth Sec RAM Reg 

| read/write 

0048H 

| Millisecond RAM Pegister 

| read/write 

0047H 

| Month Counter Register 

| read /write 

0046H 

I Date Counter Register 

| read/write 

0045H 

| Day Counter Register 

| read/write 

0044H 

| Hour Counter Register 

| read/write 

0043H 

| Minutes Counter Register 

| read/write 

0042H 

| Seconds Counter Register 

| read/write 

0O41H 

| Tenth/Hundreth Sec Counter 

j read/write 

0040H 

| Millisecond Counter Register 
-+ • ■ 

| read/write 

-.4. 


For more information on this part, see the MM 58167 A Data Sheet, National 
Semiconductor Corporation. 
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Memory and I/O Mapping 


Integral Printer Interface 


+ 

| Address 


+ 

I 0030H 


+ 


+ 

| Status /Data 


Register 


I 

+ 

I 


Type 

read/write 


+ + + 


Bit: 

7 

6 

5 

4 

3 

2 1 

0 

READ 

1 1 

1 - 1 

1 1 

1 

1 - 
1 

1 

1 - 
1 

1 

1 - 
1 

1 

1 - 
1 

INPAPER | ONLINE | 
1 OOT | | 

1 1 1 

ACK 









WRITE 

1 1 
1 D7 I 
1 1 

1 

| D 6 

1 

1 

1 D5 
1 

1 

| D4 
1 

1 

1 D3 
1 

1 1 1 

| D2 | D1 | 

1 1 1 

DO 


+ 


I 

+ 

+ 


+ 


+ 

I 

+ 

I 

+ 


Keyboard / Touchscreen Controller (8041 A) 


Address 

| Register 

+ 

1 Type 

0019H 

| Status / Command Register 

| read/write 

0018H 

| Data Register 

-+ 

| read/write 



For more information on the use of these registers, see the 
Subsystems" section, "Keyboard and Touchscreen". 


"Hardware 
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Memory and I/O Mapping 


Datacomm Port 2 Control Lines / Manuf Test Repeat 


+ 

| Address 

-+ +- 

| Register | 

Type 

1 0016H 

1 

+ 

| 0CR1/0CD1, 0CR2/0CD2, DM Ctrl. Lines, | 
j Port 1 detect, Manufac. test bit | 

+ - 

read/ write 


Bit: 7 6 5 4 3 2 1 0 

+ + 

READ | | | | POD | EM | MTST | 0CR2 | 0CR1 | 

WRITE | j j j j j j 0CD2 j 0CD1 | 

+ + 


In the above: 

POD = 0 if Port 1 datacomm PCA is not present. 

POD = 1 if Port 1 datacomm PCA is in place. 

MTST = 0 if jumper wire is not grounding U62 pin 14. 

MTST = 1 if U62 pin 14 is grounded causing repetition of 
manufacturing test segment that failed. 


Datacomm Port 1 Control Lines / Clock Source Select 


+ - + + + 

| Address | Register | Type | 

+ + + 

| OOlUH | 0CR1/0CD1, OCR2/OCD2, DM Ctrl. Lines, | read/write | 

j j Clock Source Select j j 

+ + + ~ + 

Bit: 7 6 5 ^3210 

+ + 

READ | 0 | 0 | 0 | 1 | DM | 0 | 0CR2 | 0CR1 | 

WRITE j Clock Source! j j j j 0CD2 | OCD1 j 

+ ~ — -f 


Clock source select bits are defined as follows: 


7 

— 
Bits 
1 6 

1 

1 

Receive 

Clock 

+ 

1 

1 

Transmit 

Clock 

0 

1 

0 

i 

xl6 

1 

xl6 

0 

1 

1 

1 

xl 

1 

xl 

1 

1 

0 

1 

RT 

1 

ST 

1 

1 

1 

1 

RT 

1 

ST 

— — — . 


. _ « 

"+ - * 
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Interrupt Controller (8259A) 

+ + 

| Address | Register 

+ — + 

|0010,0011H| Interrupt Controller Registers 
+ + 


+ + 

I Type | 

+ + 

| read/write | 

+ + 


For more information on this part, see the 8259A Data Sheet, Intel 
Corporation, 


Baud Rate Generator (81 16T) 


+ 

| Address 

-+ 

1 

Register 

+ 

1 Type 

— + 
1 

| OOOCH 

+ 

| Baud Rate 


Select 

| write 

+ 

T 

1 

+ 


Baud Rate Select Coding: 


Port 2 Control Port 1 Control 


+ - 

1 

1 

D7 D6 D5 D4 

-+~ 

1 

1 

D3 D2 

D1 

DO 

1 

1 

Clock Output 
(Hz.) 

- + - 
1 
1 

Baud Rate 

- + 
1 
1 

1 

0 

0 

0 

0 

1 

0 

0 

0 

0 

1 

800 

1 

50 


1 

1 

0 

0 

0 

1 

1 

0 

0 

0 

1 

1 

1200 

1 

75 


1 

1 

0 

0 

1 

0 

1 

0 

0 

1 

0 

1 

1760 

1 

no 


1 

1 

0 

0 

1 

1 

1 

0 

0 

1 

1 

1 

2152 

1 

134.5 


1 

1 

0 

1 

0 

0 

1 

0 

1 

0 

0 

1 

2400 

1 

150 


1 

1 

0 

1 

0 

1 

1 

0 

1 

0 

1 

1 

4800 

1 

300 


1 

1 

0 

1 

1 

0 

1 

0 

1 

1 

0 

1 

9600 

1 

600 


1 

1 

0 

1 

1 

1 

1 

0 

1 

1 

1 

1 

19200 

1 

1200 


1 

1 

1 

0 

0 

0 

1 

1 

0 

0 

0 

1 

28800 

1 

1800 


1 

1 

1 

0 

0 

1 

1 

1 

0 

0 

1 

1 

32000 

1 

2000 


1 

1 

1 

0 

1 

0 

1 

1 

0 

1 

0 

1 

38400 

1 

2400 


1 

1 

1 

0 

1 

1 

1 

1 

0 

1 

1 

1 

57600 

1 

3600 

* 

1 

1 

1 

1 

0 

0 

1 

1 

1 

0 

0 

1 

76800 

1 

4800 


1 

1 

1 

1 

0 

1 

1 

1 

1 

0 

1 

1 

115200 

1 

7200 


1 

1 

1 

1 

1 

0 

1 

1 

1 

1 

0 

1 

153600 

1 

9600 


1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

1 

307200 

1 

19200 


1 

+ - 

„ 








— - - 







-+- 






— 5- 


* Denotes baud rates not configurable through the HP 150 Config menus. 
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HPIB Controller (9914) 


+ 

| Address 

-+* 

1 

+ . 

Register | 

Type 

| 000BH 

— r 

Command Pass Thru /Parallel Poll | 

read/write 

| 000AH 

1 

Address Status Register | 

read 

| 0009H 

1 

Address Switch / Address Reg | 

read/write 

| 0008H 

1 

Interrupt Status O/Interrupt Mask 0 | 

read/write 

| 0007H 

1 

Data In / Data Out j 

read/write 

| 0006H 

1 

Bus Status / Auxiliary Command | 

read/write 

| 0005H 

1 

Serial Poll register | 

read 

| OOOhH 
+ 

1 

Interrupt Status 1/Interrupt Mask 1 | 

: +. 

read/write 


For more information on this part, see the TMS991^ Data Sheet, Texas 
Instruments Incorporated. 


MPSC - Datacomm Controller (7201/8274) 


+ 

| Address 

.+ 

| Register 

+ 

1 Type | 

— ...... 

| 0003H 
1 0002H 
1 0001H 
| OOOOH 

-to — _ _ _ — — 

| Channel B Control Reg 
| Channel B Data Reg 
| Channel A Control Reg 
j Channel A Data Reg 

| read/write | 
| read/write | 
j read/write | 
| read/write | 




For more information on programming this part, see the "PD7201 
Multiprotocol Serial Communications Controller Technical Manual", NEC 
Electronics U.S.A. Incorporated, or 827^ Data Sheet, Intel Corporation. 
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The software environment of the HP 150 is covered in this section. Included is 
a discussion of the operating system, MS-DOS, and HP’s enhancements to it, 
installable and BIOS devices, and the disc format and directory structure 
including drive specific capacity and organizational information. 
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System Software 


OPERATING SYSTEM STRUCTURE 


This chapter deals with the operating system on the HP 150, MS-DOS 

from Microsoft Corporation, and its interface with the HP 150 hardware and 

firmware. 

The operating system can be partitioned into several layers: 


- \ 

| Command | Invokes | Application | Invokes | Personal | 

| Processor | > | Program | < (Applications | 

j (COMMAND.COM) j | (xxxxxxxx .EXE) j | Manager | 

j (PAMCODE.EXE) j 


I 


| Basic Disc Operating! 
| System | 
I (BDOS) | 


OPERATING 

SYSTEM 

(RANDOM ACCESS 
MEMORY) 


| Basic Input/Output System | 
I (BIOS) | 


/ 


I 


| F irmware | 
| (Read Only Memory) | 


I 


I 

i Hardware | 


5-1 



System Software 


The Command Processor 

The Command Processor is a program file called COMMAND.COM. 

When r unn ing under MS-DOS COMMANDS mode, this program acts as the user interface 
to the system. Its function is to read, parse, and execute command line inputs 
such as "COPY A: # .* B:" . Command lines may come from the keyboard or from a 
batch file on disc. 

The Command Processor contains a number of built-in commands such 
as COPY, DIR, DEL, and REN. That is, these commands are recognized and acted 
upon directly by the CCMMAND.COM program . Given an input line the command 
processor first checks for a built-in command. If the input line was not a 
directive for one of the built-in commands , the first word of the command line 
is checked against filenames with the extensions .COM, .EXE, and .BAT (in that 
order) on the default disc drive. Files with extensions .COM or .EXE are 
executable programs . .COM files are single group, non-relocatable programs. 
.EXE files are relocatable. .BAT files are text files containing one or more 
command lines which are processed sequentially by the Command Processor. 

The Command Processor consists of three parts: the resident, initialization, and 
transient parts. The resident part handles all standard MSDOS errors including 
the CONTROL-C and Fatal Error Abort interrupts, plus it contains the code 
necessary to reload its transient part if necessary. The initialization portion 
contains the code necessary to process the AUTOEXEC file and determine the 
segment at which programs are to be loaded. This part of the command module is 
overlaid by the first program it loads in. The transient part of the command 
module contains all of the internal command processors and the batch file 
processor. This portion of the command module displays the disc prompt, reads 
commands from the keyboard or batchfile, and processes them. 


The Personal Applications Manager (P.A.M.) 

P.A.M. is similar in structure to the MS-DOS Command Processor, COMMAND.COM. 
However, rather than being driven by MS-DOS command line-type inputs, the 
Personal Applications Manager presents a friendly face to the user through 
touchscreen menus. Together with the File Manager, it offers essentially all 
the functionality of 

the generic MS-DOS command processor, however it is much easier for the novice 
user to operate. The CONFIG.SYS file indicates to 

MS-DOS that it should load and execute PAMCODE.EXE rather than COMMAND . COM on 
the HP 150. See the CONFIG.SYS File and System Booting sections for more 
information. 


Application Programs 

Application programs are generally program files with the extension .EXE. Both 
the Command Processor and Personal Applications Manager can invoke application 
programs . 
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Basic Disc Operating System (BDOS) 

The Basic Disc Operating System is the heart of the MS-DOS operating system. 
The BDOS is supplied by Microsoft Corporation and is standard across a wide 
variety of equipment from many vendors. BDOS presents a system -independent 
hardware interface for the Command Processor and applications programs. It is 
for this reason that applications programs written to run under MS-DOS are to a 
certain extent easily transported from machine to machine. 

The BDOS exists as a file called MSDOS.SYS residing on all MS-DOS 

system discs. It is a collection of system management and input/output 

functions termed System Functions. 

Application programs interface with the BDOS through System Function 
calls. These calls are made by loading 8088 registers on the HP 150 with 
parameters including a function number identifier, and then issuing a software 
interrupt . 

An application program written to perform all I/O and System Management 
functions through the documented BDOS System Functions will be truly machine 
independent, and capable of being run on other machines utilizing a compatible 
version of MS-DOS. However many I/O intensive applications bypass BDOS for the 
sake of efficiency, commonly accessing lower-levels of the operating system 
including the Basic Input /Output System (BIOS) and even the hardware. At this 
point, machine dependencies and non-portability is introduced. 

For details of System Functions see the HP 150 Programmers Reference Manual. 


Basic Input/Output System (BSOS) 

The Basic Input/Output System (BIOS) processes BDOS I/O requests. While the 
BDOS knows nothing of the details of the specific piece of the hardware upon 
which it runs, the BIOS is very knowledgeable. MS-DOS is customized to run on 
the HP 150 through the BIOS. 

Just as the BDOS exists on system discs as a file named MSDOS.SYS, the BIOS is 
contained in a file called 10. SYS. These two files 

are read into HP 150 RAM memory during system initialization (booting) and much 
of them remains in memory to perform I/O and System Management functions on 
behalf of applications programs. 

MS-DOS (the BDOS) invokes the BIOS for each I/O request by passing the BIOS a 
long pointer (20 bit address) to an I/O packet. This is true for all requests 
whether they are from MS-DOS itself or on behalf of its applications. The 
packet is a self-contained structure which contains all the information required 
to fully execute the I/O request. For more information on this interface, see 
“Calling a Device Driver" in this section. 

The BIOS is discussed in more detail later in this chapter. 
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OPERATING SYSTEM MEMORY USAGE 


Operating System Memory Map 


High 

Memory* 

i 

i 




i 


+ 

i 

+ 

i 

+ 

i 

+ 

i 

+ 


o68ooh+ 

1 

1 

1 

00400H+ 

I 


+ 


Transient Portion of COMMAND.COM | 

I 

--- — + 

I 

Application Program | 

(User) Area | 

(Program Segment) | 

- - + 

I 

User Stack for COMMAND . COM (256 bytes) | 

, ~ + 

PAMCODE.EXE or resident portion of COMMAND.COM | 

— — — - — — — — — — — — — — — — — — — — — — “ — — — + 

Installable Device Drivers I 


File Control Blocks (FCBs) | 

+ 

Disc Buffer Cache | 

+ 

MS-DOS (BDOS) | 

(File MSDOS.SYS) | 

- + 

BIOS | 

(File 10 . SYS) j 



F irmware I 

Variables | 

(RESERVED) j 

+ 

Interrupt Vectors I 


00000H+ 


+ 
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Interrupt Vectors 

Interrupts within the HP 150 are triggered by hardware attached to the 8088 
microprocessor, software interrupt instructions performed by MS-DOS, 
software interrupt instructions from application (user) programs, or under 
some special circumstances, by the 8088 itself. 

Every interrupt is assigned a type code that identifies it to the 8088. 
Interrupts are identified as "INT n" where n (the type code) is a 
number between 0 and 255 inclusive. The type code is used by the 8088 to 
calculate a location in the memory based interrupt vector table containing 
the four byte address of the interrupt routine. The interrupt vector for 
INT 0 is at address 00000H, the vector for INT 1 is at address OOOOUH, and 
so on. The interrupt vector table can contain up to 256 vectors, one for 
each interrupt type. 

Each entry in the table is a doubleword pointer containing the address of 
the procedure that is to service interrupts of that type. The higher 
addressed word of the pointer contains the base address of the segment 
containing the procedure. The lower addressed word contains the 
procedure’s offset from the beginning of the segment. Since each entry is 
four bytes long, the 8088 can calculate the location of the correct entry 
for a given interrupt type by simply multiplying the type by four. For 
more information on how the 8088 processor treats interrupts and the 
conditions which cause Intel-reserved interrupts, see the IAPX86/88, 
186/188 User’s Manual, Programmer’s Reference, Intel Corporation, May 1983* 

The 256 interrupt types are pre-allocated for the HP 150. The following 
table describes that allocation. 
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Starting 

Address 


Interrupt Vector 
Description 


Usage 


003FCH 

m 

# 

00200H 

1 Type 255 
1 

1 

I Type 128 

Pointer 

Pointer 

• 

(**** not used ****) 
(#**# not used #*#*) 

1 

1 

1 

1 

/l\ 

1 

1 

Available 

1 

\l/ 

001FCH 

T 

| Type 127 Pointer 

- 

( RESERVED ) 


" T 
1 


* 




, 




Reserved 

# 

~ 



# 




for HP 

00120H 

1 Type 

72 

Pointer 

- 

( RESERVED ) 


1 


0011CH 

T — — — — — - 

1 Type 

71 

Pointer 

- 

HP 150 Hardware 

(IR7) 

1 

/l\ 

00118H 

1 Type 

70 

Pointer 

- 

HP 150 Hardware 

(IR6) 

1 

1 

0011 4H 

1 Type 

69 Pointer 

- 

HP 150 Hardware 

(IR5) 

1 

Reserved 

00110H 

1 Type 

68 

Pointer 

- 

HP 150 Hardware 

(IR4) 

1 

for and 

0010CH 

1 Type 

67 Pointer 

- 

HP 150 Hardware 

(IR3) 

1 

used by HI 

00108H 

1 Type 

66 

Pointer 

- 

HP 150 Hardware 

(IR2) 

1 

hardware . 

0010UH 

1 Type 

65 Pointer 

- 

HP 150 Hardware 

(IR1) 

1 

1 

00100H 

1 Type 

64 

Pointer 

- 

HP 150 Hardware 

(IRQ) 

1 

w/ 

000FCH 

T “ “ *“ “ “ “ 

1 Type 
1 

63 

Pointer 

- 

(***» not used ****) 

I 

1 

/w 

i 

1 

000A8H 

1 

„L Type 

42 

Pointer 


(**»* not U8ed ****) 

1 

1 

! 

1 

1 

000A4H 

i Type 

41 

Pointer 

- 

MSDOS Interrupt 

29 

I 

Reserved 

000A0H 

1 Type 

40 

Pointer 

- 

MSDOS Interrupt 

28 

1 

for 

0009CH 

1 Type 

39 

Pointer 

- 

MSDOS Interrupt 

27 

1 

Microsoft 

00098H 

1 Type 

38 

Pointer 

- 

MSDOS Interrupt 

26 

1 

1 

00094H 

1 Type 

37 

Pointer 

- 

MSDOS Interrupt 

25 

1 

1 

00090H 

1 Type 

36 

Pointer 

- 

MSDOS Interrupt 

24 

1 

1 

0008CH 

1 Type 

35 

Pointer 

- 

MSDOS Interrupt 

23 

1 

1 

00088H 

| Type 

34 

Po inter 

- 

MSDOS Interrupt 

22 

1 

1 

0008UH 

1 Type 

33 

Pointer 

- 

MSDOS Interrupt 

21 

1 

1 

00080H 

1 Type 

32 

Pointer 

- 

MSDOS Interrupt 

20 

1 

« 4. . 

\l/ 

0007CH 

> 

1 Type 
1 

31 

Pointer 

- 

(**** not used ****) 

T 

1 

1 

/l\ 

1 

I 

0001 4H 

1 

1 Type 

5 

Pointer 


(*»** not uaed ****) 

1 

1 

1 

1 

Reserved 

00010H 

1 Type 

4 

Pointer 

- 

Intel Dedicated 


1 

for 

0000CH 

1 Type 

3 

Pointer 

- 

Intel Dedicated 


1 

Intel 

00008H 

1 Type 

2 

Pointer 

- 

Intel Dedicated 


1 

1 

00004H 

1 Type 

1 

Pointer 

- 

Intel Dedicated 


1 

1 

00000H 

1 Type 

0 

Pointer 

- 

Intel Dedicated 


1 

\l/ 
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MS-DOS INTERRUPTS 


Interrupt 27H 
Interrupt 26H 
Interrupt 25 H 
Interrupt 24H 
Interrupt 23H 
Interrupt 22H 
Interrupt 21H 
Interrupt 2 OH 


Terminate But Stay Resident 
Absolute Disc Write 
Absolute Disc Read 
Fatal Error Abort Address 
CONTROL-C Exit Address 
Terminate Address 
Function Request 
Program Terminate 


HP 150 HARDWARE INTERRUPTS 


IR7 : Real Time Clock (MM 58167 A) 

IR6: Not Used (Tied High) 

IR5: HPIB Controller (9914) 

IR4: ^Integral Printer, Accessory Slot NOCINT (Low Priority Open Collector) 
IR3: Keyboard and Touchscreen 

IR2: Not Used (Tied High) 

IR1: *MPSC (Datacomra Controller) , Ac cy. Slot NDCOCINT (High Priority 0/C) 
IRO: Video Controller (9007) 


* These interrupts may be initiated from an accessory board by using the 
NOCINT and NDOCOINT open collector lines. Either may be used, IR1 has 
higher priority than IR4 (IR1 will be serviced prior to IR2-IR7). See 
Accessory Board Subsystem in the Hardware Subsystems section of this 
manual . 


Firmware Variables 

The firmware uses the RAM space between 00400H and O 67 FFH for jump vectors 
and other working data storage. See Section 6, "System Firmware" for more 
information. 


BIOS and BDOS 

The Basic Input /Output System (BIOS) and the Basic Disc Operating System 
(BDOS) are loaded from disc during initialization. BDOS is loaded 
following BIOS loading and initialization, and overlays the initialization 
portion of BIOS. The origin address of MS-DOS is BIOS revision dependent. 


Disc Buffer Cache 

The Disc Buffer Cache is an area used for buffering of disc data for all 
drives. It includes portions or all of the File Allocation Tables 
(depending upon cache size), the root directory, and data for non-sector 
oriented reads and writes. The size of the Disc Buffer Cache may be 
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altered from the default by the "BUFFERS=<number>" command in the 
CONFIG.SYS file. See the CONFIG.SYS file information in this section for a 
description of the "BUFFERS" command. 

File Control Blocks (FCBs) 

File control blocks contain file information taken from the directory, and 
include pointers marking an access position. 

Two types of FCBs exist. An unopened FCB is one that contains only a drive 
specifier and a filename, which can contain wild card characters (* and ?). 
An opened FCB contains all fields filled by the MS-DOS ’Open File’ system 
function call. 

Space for two FCBs is allocated in the Program Segment Prefix (in the 
application program area) . Space is allocated above the Disc Buffer Cache 
for a number of additional FCBs. The "FILES=<number>" command in the 
CONFIG.SYS file cam be used to alter the amount of 

space allocated for FCB’s in this area. See the CONFIG.SYS file 
information in this section for a description of the "FILES" command. Note 
that each open file requires its own FCB. 


FIELDS OF THE FCB. The FCB is structured as follows : 

Size Offset 


Name 


(bytes) 


Hex 


Decimal 


I 


*T" 

| 


-f — 

1 


Drive number 

1 

i 

1 

1 

1 

00H 

1 

1 

0 

Filename 

i 

8 

“T 

1 

01-08H 

r “ 

1 

1-8 

Extension 

i 

3 

“T" 

1 

09-0BH 

— ‘“'T - 
1 

9-11 

Current block 

i 

2 

1 

OCH , ODH 

*“ “T“ 
1 

12,13 

Record size 

*T~ 

1 

2 

“ *{ 

1 

OEH , OFH 

“ -4“ 
1 

14,15 

File size 

-f “ 

1 

» 

4 

-4"” 

1 

10-13H 

1 

16-19 

Date of last write 

T 

1 

_ 

2 

-+ _ 

1 

lUH,15H 

1 — 

1 

. At — 

20,21 

Time of last write 

V ” 
1 

_ JL. _ 

2 

“T — 
1 

16H,17H 

— T — 

l 

. JL 

22,23 

Reserved 

T" 

1 

8 

“T - * 

I 

18-1FH 

-T 

l 

24-31 

Current record 

"T- 

1 

1 

-+*■ 

I 

2 OH 

“ r — 

I 

32 

Relative record 

T 

1 

- + - 

4 

-4“ 

1 

- + - 

21-24H 

I 

33-36 
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Drive Number. 

Specifies the disk drive; 1 means drive A: and 2 means drive B: and so on. 
If the FCB is to be used to create or open a file, this field can be set to 
0 to specify the default drive; the Open File system call Function (OFH) 
sets the field to the number of the default drive. 


Filename. 

Eight characters, left-aligned and padded (if necessary) with blanks. If 
you specify a reserved device name (such as PRN), do not put a colon at the 
end. 


Extension. 

Three characters, left-aligned and padded (if necessary) with blanks. This 
field can be all blanks (no extension) . 


Current Block. 

Points to the block (group of 128 records) that contains the current 
record. This field and the Current Record field (offset 20H) make up the 
record pointer. This field is set to 0 by the Open File system call. 


Record Size. 

The size of a logical record, in bytes. Set to 128 by the Open File system 
call. If the record size is not 128 bytes, you must set this field after 
opening the file. 


File Size. 

The size of the file, in bytes. The first word of this U-byte field is the 
low-order part of the size. 


Date of Last Write. 

The date the file was created or last updated. The year, month, and day 
are mapped into two bytes as follows: 


+ + + 

| offset 15H | offset lUH | 

i i i 

| 15 14 13 12 11 10 9 8 | 7 6 5 4 3 2 1 0 | 

| — + — + — + — + — + — + — | - — b — + — + — | — + — + — + — + — | 

|Y|Y|Y|Y|Y|Y|Y|M|M|M|M|D|D|D|D|D| 

| f ¥ | — — - + h + | 1 + + — - | 

| year | month | day of month | 
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Time of Last Write. 

The time the file was created or last updated. The hour, minutes, and 
seconds are mapped into two hyts as follows: 


+• 

- - - - 





— *f 

— 



— 

-+ 

1 

1 


offset 

17H 



i 


offset 16H 


1 

1 

1 

1 

15 

14 13 12 

11 

10 

9 

| 

8 | 7 

6 

5 

4 3 2 1 

0 

1 

1 


+. 

+ 

1 

1 

1 

+ 

I 

1 

1 

+ 

1 

1 

i 

— 1- 

-~~ + - 

+- 

— + — +- 

--- 



4 + + +. 

... 


1 

H | 

H | H | H | 

H | 

M | 

M | 

M | M | 

M 

1 M | 

s | S 1 S | s | 

s 

1 


+ ' 


— 1- 

— +. 

— +. 

— + +- 

... 

-+--I 

+ + + +. 

--- 


1 


hour 

1 



minute 


1 

second 


1 


Reserved. These fields are reserved for use by MS-DOS. 


Current Record. 

Points to one of the 128 records in the current block. This field and the 
Current Block field (offset OCH) make up the record pointer. This field is 
not initialized by the Open File system call. You must set it before doing 
a sequential read or write to the file. 


Relative Record. 

Points to the currently selected record, counting from the beginning of the 
file (starting with 0). This field is not initialized by the Open File 
system call. You must set it before doing a random read or write to the 
file. If the record size is less than 64 bytes, both words of this field 
are used; if the record size is 64 bytes or more, only the first three 
bytes are used. 


NOTE 


If you use the FCB at offset 05CH of the Program Segment Prefix, the last 
byte of the Relative Record field is the first byte of the unformatted 
parameter area that starts at offset 80H. This is the default Disk 
Transfer Address. 


installable Device Drivers 

The code for devices additional to those implemented in the BIOS is loaded above 
the Disc Buffer Cache. The CONFIG.SYS file contains declarations of device 
driver 

files, and these files are loaded from disc and sequentailly linked at system 
initialization time. For more information on this process and device drivers in 
general, see the "HP 150 Devices", the "CONFIG.SYS File" and "Operating System 
Initialization/Booting" discussions later in this section. 
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PAMCODE.EXE or Resident Portion of COMMAND.COM 

The resident portion of COMMAND.COM contains the code necessary to determine if 
the transient portion needs to be reloaded (a checksum test), and contains the 
code to do the reloading of that transient portion. It also contains the 
interrupt 22H, 23H, and 2UH handlers. PAMCODE.EXE is fully resident, that is it 
does not contain a transient portion in high memory as does COMMAND.COM. As 
such, if PAMCODE.EXE is declared as the SHELL in the CONFIG.SYS file, quite a 
deal of system memory will be consumed by this user interface. 


Application Program Area (Program Segment) 

When am external command is typed, or when a program is executed through P.A.M. 
or through the EXEC system call, MS-DOS determines the lowest available free 
memory address to use as the start of the program. This area is called the 
Program Segment. 

The first 256 bytes of the Program Segment are set up by the EXEC system call to 
use as the Program Segment Prefix (PSP) Control Block. 

The program is then loaded following this block. An .EXE file with rainalloc and 
maxalloc both set to zero is 
loaded as high as possible. 
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PROGRAM SEGMENT PREFIX (PSP) CONTROL BLOCK At offset 0 within the program 
segment, MS-DOS builds the Program Segment Prefix (PSP) control block. The 
format of this block is as follows: 


000H+- 


008H+ 


INT 20H 


+ + + 

End of | | Long call to MS- 

alloc . j Reserved | DOS function dis- 

block | | patcher (5 bytes) 


Terminate address 
(IP, CS) 


I 

| CTRL-C exit 
| address (IP) 


010H+ 


CTRL-C exit 
address^ (CS) 


Hard error exit address 
(IP, CS) 


I 

-+ 


Used by MS-DOS 
02CH 
05CH 


+ 


Formatted Parameter Area 1 formatted as standard 
unopened FCB 06CH 


Formatted Parameter Area 2 formatted as standard 
unopened FCB (overlaid if FCB 05CH is opened) 
080H+ — 

Unformatted Parameter Area 
(default Disk Transfer Area) 

100H+ — 


| NOTE 


Programs must not alter any part of the Program Segment 
Prefix control block below offset 05CH. 
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HOW A PROGRAM TERMINATES 

A user (application) program may return to EXEC by one of four 
methods : 

1. A long jump to offset 0 in the Program Segment 
Prefix (PSP) 

2. By issuing an I NT 20H with CS:0 pointing to the PSP 

3. By issuing an I NT 21H with register AH=0 with CS: 0 
pointing at the PSP, or UCH and no restrictions on CS 

4. By a long call to location 50H in the Program Segment 
Prefix with AH=0 or Function Request 4CH 


NOTE 


It is the responsibility of all programs to ensure that the CS register contains 
the segment address of the Program Segment Prefix when terminating via any of 
these methods, except Function Request 4CH. For this reason, using Function 
Request 4CH is the preferred method. 

All four methods result in transferring control to the program that issued the 
EXEC. During this returning process, Interrupts 22H, 23H, and 24H (Terminate 
Address, CONTROL -C Exit Address, and Fatal Error Abort Address) addresses are 
restored from the values saved in the Program Segment Prefix of the terminating 
program. Control is then given to the terminate address. If this is a program 
returning to COMMAND.COM, control transfers to its resident portion. If a batch 
file was in process, it is continued; otherwise, COMMAND.COM performs a checksum 
on the transient part, reloads it if necessary, then issues the system prompt 
and waits for you to type the next command. 


CONDITIONS IN EFFECT WHEN A PROGRAM RECEIVES CONTROL 


For All Programs. 

The segment address of the passed environment is contained at offset 2CH in the 
Program Segment Prefix. 

The environment is a series of ASCII strings (totaling less than 32K) in the 
form: 


NAME=parameter 

Each string is terminated by a byte of zeros, and the set of strings is 
terminated by another byte of zeros. The environment built by the command 
processor contains at least a COMSPEC=string (the parameters on COMSPEC define 
the path used by MS-DOS to locate COMMAND.COM on disk). The last PATH and 
PROMPT' commands issued will also be in the environment, along with any 
environment strings defined with the MS-DOS SET command. 
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The environment that is passed is a copy of the invoking process environment* 
If your application uses a "keep process" concept, you should be aware that the 
copy of the environment passed to you is static. That is, it will not change 
even if subsequent SET, PATH, or PROMPT commands are issued. 

Offset 50H in the Program Segment Prefix contains code to call the MS-DOS 
function dispatcher. By placing the desired function request number in AH, a 
program can issue a far call to offset 50H to invoke an MS-DOS function, rather 
than issuing an Interrupt 21H. Since this is a call and not an interrupt, 
MS-DOS may place any code appropriate to making a system call at this position. 
This makes the process of calling the system portable. 

The Disk Transfer Address (DTA) is set to 80H (default DTA 
in the Program Segment Prefix). 

File control blocks at 5CH and 6CH are formatted from the first two parameters 
typed when the command was entered. If either parameter contained a pathname, 
then the corresponding FCB contains only the valid drive number. The filename 
field will not be valid. 

An unformatted parameter area at 8lH contains all the characters typed after 
the command (including leading and imbedded delimiters), with the byte at 80H 
set to the number of characters. If the < 9 >, or parameters were typed on the 
command line, they (and the filenames associated with them) will not appear in 
this area; redirection of standard input and output is transparent to 
applications. 

Offset 6 (one word) contains the number of bytes available in the segment. 

Register AX indicates whether or not the drive specifiers (entered with the 
first two parameters) are valid, as follows: 

AL=FFH if the first parameter contained an invalid 
drive specifier (otherwise AL=00H) 

AH=FFH if the second parameter contained an invalid 
drive specifier (otherwise AH=00H) 

Offset 2 (one word) contains the segment address of the first byte of 
unavailable memory. Programs must not modify addresses beyond this point unless 
they were obtained by allocating memory via the Allocate Memory system call 
(Function Request U8H). 


For .EXE Executable Programs. 

DS and ES registers are set to point to the Program Segment Prefix. CS,IP,SS, 
and SP registers are set to the values passed by MS-LINK. 


For .COM Executable Programs. 

All four segment registers contain the segment address of the initial allocation 
block that starts with the Program Segment Prefix control block. 
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All of user memory is allocated to the program. If the program invokes another 
program through Function Request 4BH, it must first free some memory through the 
Set Block (UAH) function call, to provide space for the program being executed. 

The Instruction Pointer (IP) is set to 100H. 

The Stack Pointer register is set to the end of the program’s segment. The 
segment size at offset 6 is reduced by 100H to allow for a stack of that size. 

A word of zeros is placed on top of the stack. This is to allow a user program 
to exit to CCWMAKD.COM by doing a RET instruction last. This assumes , however, 
that the user has maintained his stack and code segments. 


Transient Portion of COMMAND.COM 

These are the command interpreter, internal commands and batch processing 
portions of COMMAND.COM. This area may be legally destroyed (overlayed) by an 
application program, and if it is then it is reloaded from disc at application 
program termination time. 
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HP 150 DEVICES 


There are two classes of "devices" associated with the HP 150. These are 
logical devices and physical devices. 


Logical (Mappable) Devices 

Logical devices can be thought of as generic types of input/output channels. 
Logical devices are named in a symbolic manner. For example, the device name 
"PRN" refers to printer, the name "CON" refers to console. The following 
logical device names are supported by the operating system BIOS Version A. 01. 02: 


* "CON " - 

"C0M1 " - 

"COM2 " - 

"AUX " - 

"PRN " - 

* "CLOCK " - 

"LST " - 

"PLT " - 

* "HPIBDEV" - 

» " INT •• _ 

"LPT1 " - 

"LPT2 " - 

"LPT3 " - 

II II-qM 11^,11 


Console Device 

Primary Communication Device 

Secondary Communication Device 

Auxiliary Device 

Printer Device 

Clock Device 

List Device 

Plotter Device 

HPIB Device 

Internal Printer Device 

Parallel Printer Device 1 (another name for PRN) 

Parallel Printer Device 2 (another name for LST) 

Parallel Printer Device 3 (another name for AUX) 

Disc Drives 


Note: * These named devices have actual physical devices associated directly 

with them and thus are not mappable. All of the other named devices 
are mappable. 


Physical Devices 

The physical class of devices on the HP 150 are the hardware input/output 
entities. 

These include the 


- Serial Communications Port 1 

- Serial Communications Port 2 

- Real Time Clock 

- Keyboard 

- Display Screen 

- Integral Printer 

- HPIB Port. 


Mapping Logical to Physical Devices 

The HP 150 personal computer is uniquely flexible when it comes to the 
assignment of logical to physical devices. The logical devices may be "mapped" 
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to physical devices. In this respect, the HP 150 differs from most common 
personal computers. Some other common personal computers for example have fixed 
logical to physical device mapping. The serial communications devices C0M1 and 
COM2 are permanently mapped to specific hardware I/O addresses carried on 
internal board connectors. While this presents a simple system architecture, it 
also carries with it a rather rigid one. 

The Device Configuration Utility 

The HP 150 has a piece of non-volatile memory which contains active logical to 
physical mapping information. An applications program called "DEVCONFG.EXE" 
allows you to change the mapping stored here. 

DEVCONFG is a menu driven application and its usage is described in the HP 150 
Owner’s Guide. Conceptually, the mapping scheme looks like this: 


PRN LST AUX PLT C0M1 COM2 A B C L 


CMOS NON-VOLATILE MEMORY 
Logical to physical device mapping tables 


FIRMWARE 

("ROM 

BIOS") 

DEVICE 

DRIVERS 


HARDWARE | Port | Port | RTC | Keyboard | Display | Integral | HPIB | 
DEVICES j 1 I 2 I I I I Printer | j 


1 

Port | 

Port 

1 

1 

1 1 
RTC | Keyboard | 

1 

Display | 

1 

Integral | 

HPIB | 

1 1 

2 

1 

Driver | Driver | 

Driver | 

Printer | 

Driver | 

Driver | Driver 
1 

1 

1 

1 1 
1 1 

1 

1 

Driver | 
1 




BIOS 
(10. SYS) 
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Installable Devices 

There is really a third class of devices on the HP 150. These devices are 
termed "installable devices". They combine the attributes of both logical and 
physical devices. Installable devices cam be created by the system programmer 
to implement I/O. Installable devices are given names just as the logical 
devices are however installable devices are implemented outside the BIOS. An 
example of an installable device might be "NET" — a network. 

Installable devices are really entities unto themselves. They are not mappable 
(through the CMOS logical to physical device mapping tables) in current HP 150 
implementations nor are they recognized by the device configuration utility. 
Upcoming versions of the operating system will allow installable devices to be 
mapped into the system device configuration however. 

An installable device consists of some executable object code termed a "device 
driver". The code is stored on the operating system disc 

as a file with the extension . COM (for example iIETOORK.COM) . The device driver 
generally implements all levels of the I/O interface from its BDOS interface 
down to the hardware itself. 

Installable devices cam be thought of as extensions to the BIOS. They allow for 
I/O expansion of sin MS-DOS based system. The device architecture is described 
in the following diagram. 
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| Application Program 


| BDOS 

j [MSDOS.SYS] 

| (Basic Disc Operating System 


I 

I 


| BIOS | 

1 

Installable | 

| [10. SYS] | 

1 

Device | 

1 ! 

1 

1 

Drivers | 

i 

1 

1 

1 

1 

i 

[.COM Files] | 

| Firmware 


1 

1 

| ("ROM BIOS") 

1 

1 


1 

1 

1 

1 

1 

1 

Hardware 

1 

| (Fixed 

and Accessories) | 


Installable devices share the same calling conventions as the BIOS devices. A 
discussion of how to implement installable device drivers appears later in this, 
the system software section. 
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Character Devices and Block Devices 

There axe two kinds of devices: 

Character devices 
Block Cevices 

Character devices are designed to perform serial character I/O like CON, AUX, 
and PRN. These devices are named (i*e., CON, AUX, CLOCK, etc.)* and users may 
open channels (handles or FCBs) to do I/O to them. 

Block devices are the “disk drives" on the system. They can perform random I/O 
in pieces called blocks (usually the physical sector size). These devices are 
not named as the character devices are, and therefore cannot be opened directly. 
Instead they are identified via the drive letters (A:, B: , C:, etc.). 

Block devices also have units. A single driver may be responsible for one or 
more disk drives. For example, block device driver ALPHA may be responsible for 
drives A:,B:,C: and D: . This means that it has four units (0-3) defined and, 
therefore, takes up four drive letters. If driver ALPHA is the first block 
driver in the device list, and it defines k units (0-3) > then they will be 
A:,B:,C: and D: . If BETA is then the second block driver and defines three 
units (0-2), then they will be E:,F: and G: , and so on. MS-DOS 2.0 is not 
limited to 16 block device units, as previous versions were. The theoretical 
limit is 63 (26-1), but it should be noted that after 26 the drive letters are 
unconventional (such as ], \, and .). 


NOTE 


Character devices cannot define multiple units because they have only one name. 


How Application Programs Can Get to Devices 

The BDOS (the heart of MS-DOS) serves as an interface for dealing with devices. 
Many of the MS-DOS System Functions access devices implemented in the BIOS. 
These System Functions include functions to input and output characters to the 
CON, AUX, said PRN devices, functions to perform block I/O (reads and writes) to 
character (CON, AUS, PRN) and block (A,B,C. . .etc. ) devices, and functions to 
perform block device file directory (create, open, close) operations. 

A special I/O control function allows control information to be passed to 
devices. This may be used for example to perform special CON device functions 
including the whole AGIOS function library. MS-DOS also allows access to 
installed devices through many of its system functions. 

Application programs for the sake of portability should gain access to devices 
through the MS-DOS (BDOS) System Function Calls. See "Accessing Devices through 
MS-DOS" later in this chapter for more information. 
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Device Driver Structure 

A device driver is a binary file with all of the code in it to manipulate the 
hardware and provide a consistent interface to MS-DOS. In addition, it has a 
special header at the beginning that identifies it as a device, defines the 
strategy and interrupt entry points, and describes various attributes of the 
device. 

| MOTE I 


For device drivers, the file must not use the ORG 100H (like .COM files). 
Because it does not use the Program Segment Prefix, the device driver is simply 
loaded; therefore, the file must have an origin of zero (ORG 0 or no ORG 
statement) . 

A device header is required at the beginning of a device driver. 

A device header looks like this: 


DWORD pointer to next device 
(Must be set to -1) 


WORD attributes 

Bit 15 = 1 if char device 0 is blk 
if bit 15 is 1 

Bit 0 = 1 if current sti device 

Bit 1 * 1 if current sto output 

Bit 2 = 1 if current NUL device 

Bit 3 “ 1 if current CLOCK dev 

Bit k = 1 if special 

Bits 15-12 Reserved, must be set to 0 

Bit 14 is the IOCTL bit 

Bit 13 is the MON IBM FORMAT bit 


WORD pointer to device’s strategy entry 
point 


WORD pointer to device’s interrupt entry 
point 


8 -BYTE character device name field 
Character devices set a device by name. 
For block devices the first byte is 
the number of units, the other 7 are not 
used 


Mote that the device entry points are words. They must be offsets from the same 
segment number used to point to this table. For example, if XXX: YYY points to 
the start of this table, then XXX: strategy and XXX : interrupt are the entry 
points. 
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POINTER TO NEXT DEVICE FIELD The pointer to the next device header field is a 
double word field (offset followed by segment) that is set by MS-DOS to point at 
the next driver in the system list at the time the device driver is loaded. See 
the "Device List" discussion which appears later in this chapter. It is 
important that this field be set to -1 prior to load (when it is on the disk as 
a file) unless there is more than one device driver in the file. If there is 
more than one driver in the file, the first word of the double word pointer 
should be the offset of the next driver’s Device Header. 


NOTE 


If there is more than one device driver in the installable device driver file, 
the last driver in the file must have the pointer the next Device Header field 
set to -1. 


ATTRIBUTE FIELD 

The attribute field is used to tell the system whether this device is a block or 
character device (bit 15)- Most other bits are used to give selected character 
devices certain special treatment . (Note that these bits mean nothing on a 
block device). For example, assume that a user has a new device driver that he 
wants to be the standard input and output. Besides installing the driver, he 
must tell MS-DOS that he wants his new driver to override the current standard 
input and standard output (the CON device). This is accomplished by setting the 
attributes to the desired characteristics, so he would set bits 0 and 1 to 1 
(note that they are separate!). Similarly, a new CLOCK device could be 
installed by setting that attribute. (Refer to "The CLOCK Device", in this 
chapter for more information.) Although there is a NUL device attribute, the 
NUL device cannot be reassigned. This attribute exists so that MS-DOS can 
determine if the NUL device is being used. 

The NON IBM FORMAT bit applies only to block devices and affects the operation 
of the BUILD BPB (Bios Parameter Block) device call. (Refer to "Media Check" 
and "Build BPB" in the "Calling a Device Driver" section later in this chapter 
for further information on this call.) 

The other bit of interest is the IOCTL bit, which has meaning on character and 
block devices. This bit tells MS-DOS whether the device can handle control 
strings (via the IOCTL system call. Function kkE) . 

It a driver cannot process control strings, it should initially set this bit to 
0. This tells MS-DOS to return an error if an attempt is made (via Function 
4UH) to send or receive control strings to this device. A device which can 
process control strings should initialize the IOCTL bit to 1. For drivers of 
this type, MS-DOS will make calls to the IOCTL INPUT and OUTPUT device functions 
to send and receive IOCTL strings. 

The IOCTL functions allow data to be sent and received by the device for its own 
use (for example, to set baud rate , stop bits, and form length), instead of 
passing data over the device channel as does a normal read or write. The 
interpretation of the passed information is up to the device, but it must not be 
treated as a normal I/O request. 
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STRATEGY AND INTERRUPT ROUTINES 

These two fields are the pointers to the entry points of the strategy and 
interrupt routines. The strategy and interrupt routines are the actual device 
driver code. They are word values so they roust be in the same segment as the 
Device Header, 

The 2.0 DOS does not really make use of two entry points (it simply calls 
strategy, then immediately calls interrupt). This dual entry point scheme is 
designed to facilitate future multi-tasking versions of MS-DOS. In 
multi-tasking environments I/O must be asynchronous, to accomplish this the 
strategy routine will be called to queue (internally) a request and return 
quickly. It is then the responsibility of the interrupt routine to perform the 
actual I/O at interrupt time by picking requests off the internal queue (set up 
by the strategy routine), and process them. When a request is complete, it is 
flagged as "done" by the interrupt routine. The DOS periodically scans the list 
of requests looking for ones flagged as done, and "wakes up" the process waiting 
for the completion of the request. 

In order for requests to be queued as above it is no longer sufficient to pass 
I/O informatin in registers, as was the case in earlier versions, since many 
requests may be pending at any one time. Therefore the new device interface 
uses data "packets" to pass request information. A device is called with a 
pointer to a packet called a Request Header, this packet is linked into a global 
chain of all pending I/O requests maintained by the DOS. The device then links 
the packet into its own local chain of requests for this particular device. The 
device interrupt routine picks requests of the local chain for processing. The 
DOS scans the global chain looking for completed requests. These packets are 
composed of two pieces, a static piece xrtiich has the same format for all 
requests (called the static request header), which is followed by information 
specific to the request. Thus packets have a variable size and format. 

At this point it should be emphasized that MS-DOS 2.0 does not implement most of 
these features, as future versions will. There is no global or local queue. 
Only one request is pending at any one time, and the DOS waits for this current 
request to be completed. For 2.0 it is sufficient for the strategy routine to 
simply store the address of the packet at a fixed location, and for the 
interrupt routine to then process this packet by doing the request and 
returning. 

Remember: The DOS just calls the strategy routine and then immediately calls the 
interrupt routine, it is assumed that the request is completed when the 
interrupt routine returns. 


NAME FIELD 

This is an 8-byte field that contains the name of a character device or the 
number of units of a block device. If it is a block device, the number of units 
can be put in the first byte. v This is optional, because MS-DOS will fill in 
this location with the value returned by the driver’s XNXT code. Refer to 
"Installation of Device Drivers" in this chapter for more information. 
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Device List 

A list of all devices accessible by the operating system is maintained in RAM 
memory on the HP 150. The list includes each device supported by the BIOS 
together with any installable device drivers loaded from disc during 
initialization of the operating system. 

During operating system initialization, the SYSINIT routine provided by 
Microsoft the BIOS reads a file called CONFIG.SYS located on the 
operating system disc. If any installable device drivers are to be installed, 
the CONFIG.SYS file should contain an entry such as 

DEVICE = NETWORK. SYS 

for each installable device. SYSINIT will load the device 

driver from disc (the file "NET.COM" in the above example) and link it into the 
list of existing device drivers. This device list contains both the boot 
(default BIOS) drivers and any installable device drivers found referenced in 
the CONFIG.SYS file. The system always processes the installable device drivers 
first and links them in ahead of the default ones, thus allowing the user to 
override default devices if be so chooses. 

The format of the entries in the system’s device list is the same as that of the 
device header required at the beginning of an installable device driver file. 
The details of this structure have been described, but in general it consists of 
the device specific information MSDOS needs to utilize each device. Such 
entries as the device type, and pointers to the device driver’s strategy and 
interrupt routines are found in the system’s device list structure. MSDOS 
requires that there be at least four devices defined by this list at boot time. 
They must be both the first four entries in this list and they must implement 
the CON, AUX, PRN, and CLOCK devices. The minimum system device list would then 
appear as follows: 
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An installable device driver with the sane name as one of these BIOS resident 
devices will be linked in at that position, thus preempting the default device 
of the same name. As such, BIOS devices may be replaced by installable devices 
of the same name. Additional devices of either type (block or character) will 
be added to the system (whether they reside in BIOS or on disc) by updating the 
"next device driver" field of the last entry in this list to the point to the 
additional drivers. The SYSINIT module of the BIOS is responsible for bringing 
in the installable device drivers from the disc and inserting them in this list 
as pictured above. Once all of the installable drivers have been linked in, 
MS-DOS scans the preset list of default or BIOS resident device drivers, and 
links them into this list. The logical device names for the block devices (the 
labels A, B, C, etcetera) are determined by the position of the block device in 
the device list, and by how many units each device driver supports. The first 
unit of the first block device driver in the device list is assigned the label 
A, the second B, and so on. 


How to Create a Device Driver 

In order to create a device driver that MS-DOS can install, you must write a 
binary file with a Device Header at the beginning of the file. Note that for 
device drivers, the code should not be originated at 100H, but rather at 0. The 
link field (pointer to next Device Header) should be -1, unless there is more 
than one device driver in the file. The attribute field and entry points must 
be set correctly. 

If it is a character device, the name field should be filled in with the name of 
that character device. The name can be any legal 8-character filename. 

MS-DOS always processes installable device drivers before handling the default 
devices, so to install a new CON device, simply name the device CON. Remember 
to set the standard input device and standard output device bits in the 
attribute word on a new CON device. The scan of the device list stops on the 
first match, so the installable device driver takes precedence. 


HOT& 


Because MS-DOS can install the driver anywhere in memory, care must be taken in 
any far memory references. You should not expect that your driver will always 
be loaded in the same place every time. 
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HOW MS-DOS CALLS A DEVICE DRIVER 


Request Header 

When MS-DOS receives a reference to a device it scans the device 
list to find the first match of the referenced device. From this list it pulls 
the pointer to the device’s strategy routine and calls the code with a device 
request header. The strategy routine simply saves a pointer to the segment and 
offset of the start of the device request header, and returns to the DOS. The 
DOS then immediatly calls the device’s interrupt routine, where the request 
header is examined and acted upon as requested. It is the responsibility of the 
device’s interrupt routine to examine the command code in the request header, 
transfer control of the routine to process that command, set the status word in 
the request header appropriatly , fill in any command specific parameters, and 
return to the DOS. 

A pointer to the Request Header is passed to the strategy entry point in ES:BX. 
is made up of a piece of fixed- length data (the Static Request Header) followed 
by data pertinent to the operation being performed. Note that is is the device 
driver’s responsibility to preserve the machine state (for example, save all 
registers on entry and restore them on exit). There is enough room on the stack 
when strategy or interrupt is called to do about 20 pushes. If more stack is 
needed, the driver should set up its own stack. 

The following figure illustrates the static portion of a Request Header. 

STATIC REQUEST HEADER -> 


BYTE length of record 
Length in bytes of this 
Request Header 


BYTE unit code 
The subunit the operaton 
is for (minor device) 

(no meaning on character 
devices) 


BYTE command code 


WORD status 


8 bytes RESERVED 


UNIT CODE The unit code field identifies which unit of a block device in your 
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device driver the request is for. For example, if your device driver has 3 
units defined, then the possible values of the unit code field would be 0, 1, 
and 2. 


COMMAND CODE FIELD Hie command code field in the Static Request Header 
specifies the function to be performed and can have the following values: 


Command 

Code Function 


0 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 


INIT 

MEDIA CHECK (Block only, NOP for character) 
BUILD BPB (Block only, NOP for character) 
IOCTL INPUT (Only called if device has I0CTL) 
INPUT (read) 

NON-DESTRUCTIVE INPUT NO WAIT (Char devs only) 
INPUT STATUS (Char devs only) 

INPUT FLUSH (Char devs only) 

OUTPUT (write) 

OUTPUT (write) with verify 


OUTPUT STATUS (Char devs only) 
OUTPUT FLUSH (Char devs only) 
IOCTL OUTPUT (Only called if device has IOCTL) 


These functions are described in detail later in the section. 


STATUS WORD The following figure illustrates the status word in the Request 
Header . 


15 14 13 12 11 10 9 8 7 6 5 4 3 2 1 0 


I E | I B | D | | 

| R | RESERVED | U | 0 | ERROR CODE (bit 15 on) | 

I R I I S | N | I 


The status word is zero on entry and is set by the driver interrupt routine on 
return . 

Bit 8 is the one bit. When set, it means the operation is complete. For MS-DOS 
2.0, the driver sets it to 1 when it exits. 

Bit 15 is the error bit. If it is set, then the low 8 bits indicate the error. 
The errors are: 
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0 Write protect violation 

1 Unknown Unit 

2 Drive not ready 

3 Unknown command 

4 CRC error 

5 Bad drive request structure length 

6 Seek error 

7 Unknown media 

8 Sector not found 

9 Printer out of paper 
A Write fault 

B Read fault 
C General failure 

Bit 9 is the busy bit, which is set only by status calls. 

For output on character devices : If bit 9 is 1 on return, a write request 

(if made) would wait for completion of a current request. If it is 0, 
there is no current request, and a write request (if made) would start 
immediately. 

For input on character devices with a buffer : If bit 9 is 1 on return, a 

read request (if made) would go to the physical device. If it is 0 on 
return, then there are characters in the device buffer and a read would 
return quickly. It also indicates that something has been typed. MS-DOS 
assumes all character devices have an input type -ahead buffer. Devices 
that do not have a type -ahead buffer should always return busy=0 so that 
MS-DOS will not continuously wait for something to get into a buffer that 
does not exist. 

One of the functions defined for each device is INIT. This routine is called 
only once when the device is installed. The INIT routine returns a location 
(DS:DX), which is a pointer to the first free byte of memory after the device 
driver (similar to "Keep Process"). This pointer method can be used to delete 
initialization code that is only needed once, saving on space. 

Block devices are installed the same way and also return a first free byte 
pointer as described above. Additional information is also returned: 

The number of units is returned. This determines logical device names. If 
the current maximum logical device letter is F at the time of the install 
call, and the INIT routine returns 4 as the number of units, then they will 
have logical names G, H, I, and J. This mapping is determined by the 
position of the driver in the device list, and by the number of units on 
the device (stored in the first byte of the device name field). 

A pointer to a BPB (BIOS Parameter Block) pointer array is also returned. 
There is one table for each unit defined. These blocks will be used to 
build an internal DOS data structure for each of the units. The pointer 
passed to the DOS from the driver points to an array of n word pointers to 
BPBs, where n is the number of units defined. In this way, if all units 
are the same, all of the pointers can point to the same BPB, saving space. 
Note that this array must be protected (below the free pointer set by the 
return) since an internal DOS structure will be built starting at the byte 
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pointed to by the free pointer. The sector size defined must be less than 
or equal to the maximum sector size defined at default BIOS INIT time. If 
it isn’t, the install will fail. 

The last thing that INIT of a block device must pass back 

is the media descriptor byte. This byte means nothing to MS-DOS, but is 
passed to devices so that they know what parameters MS-DOS is currently 
using for a particular drive unit. 

Block devices may take several approaches; they may be dumb or smart . A dumb 
device defines a unit (and therefore an internal DOS structure) for each 
possible media drive combination. For example, unit = drive 0 single side, unit 
1 = drive 0 double side. For this approach, media descriptor bytes do not mean 
anything. A smart device allows multiple media per unit . In this case, the BPB 
table returned at INIT must define space large enough to accommodate the largest 
possible media descriptor byte to pass information 
about what media is currently in a unit. 
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Device Driver Functions and Parameters 

All strategy routines are called with ES:BX pointing to the Request Header. The 
interrupt routines get the pointers to the Request Header from the queue that 
the strategy routines store them in. The command code in the Request Header 
tells the driver which function to perform. 

NOTE 

All DWORD pointers are stored offset first, then segment. 


INIT 

Command code 3 0 
INIT - ES:BX -> 


13-BYTE Static Request Header 


BYTE # of units 


DWORD break address 


DWORD pointer to BPB array 
(Not set by character devices) 


The number of units, break address, and BPB pointer are set by the driver. On 
entry, the DWORD that is to be set to the BPB array (on block devices) points to 
the character after the ’ = ’ on the line in CONFIG.SYS that loaded this device. 
This allows drivers to scam the CONFIG.SYS invocation line for arguments. 


I NOTE I 

If there are multiple device drivers in a single device driver file, the ending 
address returned by the last INIT called will be the one MS-DOS uses. It is 
recommended that all of the device drivers in a single device driver file return 
the same ending address. 
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MEDIA CHECK Carnand Code = 1 

MS-DOS calls MEDIA CHECK first for a drive unit. MS-DOS passes it? current 
media descriptor byte (refer to the section "Media Descriptor Byte" later in 
this chapter) . 

MEDIA CHECK - ES:BX -> 


13-BYTE Request Header 


BYTE media descriptor from DPB 


BYTE returned 


In addition to setting the status word, the driver must set the return byte to 
one of the following: 


Media Not Changed - current DPB and media byte are OK. 

Media Changed - Current DPB and media are wrong. MS-DOS invalidates any 
buffers for this unit and calls the device driver to build the BPB with 
media byte and buffer. 

Not Sure If there are dirty buffers (buffers with changed data, not yet 
written to disk) for this unit, MS-DOS assumes the DPB and media byte are 
OK (media not changed). If nothing is dirty, MS-DOS assumes the media has 
changed. It invalidates any buffers for the unit , and calls the device 
driver to build the BPB with media byte and buffer. 

Error - If an error occurs, MS-DOS sets the error code accordingly. 

-1 Media has been changed 

0 Don’t know if media has been changed 

1 Media has not been changed 

If the driver can return -1 or 1 (by having a door-lock or other interlock 
mechanism) MS-DOS performance is enhanced because MS-DOS does not need to reread 
the FAT for each directory access. 


5-32 



System Software 


BUILD BPP (BIOS PARAMETER BLOCK) 

Command code 3 2 

MS-DOS will call BUILD BPB under the following conditions: 

If Media Changed is returned 

If Not Sure is returned, and there are no dirty buffers. 

The BUILD BPB call also gets a pointer to a one-sector buffer. What this buffer 
contains is determined by the NON IBM FORMAT bit in the attribute field. If the 
bit is zero (device is IBM format - compat ible ) , then the buffer contains the 
first sector of the first File Allocation Table (FAT) . The FAT IB byte is the 
first byte of this buffer. 

j NOTE 

The BPB must be the same, as iar as location oi the FAT is concerned, for all 
possible media because this first FAT sector must be read before the actual BPB 
is returned. If the NON IBM FORMAT bit is set, then the pointer points to one 
sector of scratch space (which may be used for anything) . 

BUILD BPB - ES:BX -> 


13 -BYTE Request Header 


BYTE media descriptor from DPB 


DWORD transfer addres* | 

(Points to one sector worth of | 
scratch space or first sector | 
of FAT depending on the value | 
of the NON IBM FORMAT bit) j 


DWORD pointer to BPB 


If the NON IBM FORMAT bit of the device is set, then the DWORD transfer address 
points to a one sector buffer, which can be used for any purpose. If the NON 
IBM FORMAT bit is 0, then this buffer contains the first sector of the first FAT 
and the driver must not alter this buffer. 

If IBM compatible format is used (NON IBm FORMAT BIT = 0), then the first sector 
of the first FAT must be located at the same sector on all possible media. This 
is because the FAT sector will be read BEFORE the media is actually determined. 
Use this mode if all you want is to read the FAT ID byte. 

In addition to setting status word, the driver must set the Pointer to the BPB 
on return. 
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In order to allow for many different OEMs to read each other’s disks, the 
following standard is suggested. The information relating to the BPB for a 
particular piece of media is kept in the boot sector for the media. In 
particular, the format of the boot sector is: 

BUILD BPP - ES:BX -> 


B 

P 

B 

I 

V 


I 

B 

P 

B 


3 BYTE near JUMP to boot code 


8 BYTES OEM name and version 


WORD bytes per sector 


BYTE sectors per allocation unit 


WORD reserved sectors 


BYTE number of FATs 


WORD number of root dir entries 


WORD number of sectors in logical 
image 


BYTE media descriptor 


WORD number of FAT sectors 


WORD sectors per track 


WORD number of heads' 


WORD number of hidden sectors 


The three words at the end (sectors per track, number of heads, and number of 
hidden sectors) are optional. They are intended to help the BIOS understand the 
media. Sectors per track may be redundant (could be calculated from total size 
of the disk) . Humber of heads is useful for supporting different multi-head 
drives which have the same storage capacity, but different numbers of surfaces. 
Humber of hidden sectors may be used to support drive -partitioning schemes. 


Media Descriptor Byte 

The last two digits of the FAT ID byte are called the media descriptor byte. 
Currently, the media descriptor byte has been defined for a few media types, 
including 5~lA" and 8" standard disks. 

Although these media bytes map directly to FAT ID bytes (which are constrained 
to the 8 values F8H-FFH), media bytes can, in general, be any value in the range 
OGH-FFH. 
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READ OR WRITE Command codes * 3, 4, 8, 9, and 12 
READ or WRITE - ES:BX (Including IOCTL) -> 

| 13-BYTE Request Header | 

I- 1 

| BYTE media descriptor from DPB | 

| , 

| DWORD transfer address | 

| , 

| WORD byte/sector count | 

I I 

| WORD starting sector number | 

| (Ignored on character devices) | 


In addition to setting the status word, the driver must set the sector count to 
the actual number of sectors (or bytes) transferred. Ho error check is 
performed on an IOCTL I/O call. The driver must correctly set the return sector 
(byte) count to the actual number of bytes transferred. 


The Following Applies to Block Device Drivers: 

Under certain circumstances the BIOS may be asked to perform a write operation 
of 64K bytes, which seems to be a "wrap around" of the transfer address in the 
BIOS I/O packet. This request arises due to an optimization added to the write 
code in MS-DOS. It will only manifest on user writes that are within a sector 
size of 64K bytes on files "growing" past the current EOF. It is allowable for 
the BIOS to ignore the balance of the write that "wraps around* 1 if it so 
chooses . For example, a write of 10000H bytes worth of sectors with a transfer 
address of XXX :1 could ignore the last two bytes. A user program cam never 
request an I/O of more than FFFFH bytes and cannot wrap around (even to 0) in 
the transfer segment. Therefore, in this case, the last two bytes can be 
ignored . 
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NON DESTRUCTIVE READ NO WAIT 
Cormand code ■ 5 

NON DESTRUCTIVE READ NO WAIT - ES:BX -> 

| 13 -BYTE Request Header | 

I— — 1 

| BYTE read from device | 


If the character device returns bit = 0 (characters in buffer), then the next 
character that would be read is returned. This character is not removed from 
the input buffer (hence the term "Non Destructive Read”). Basically, this call 
allows MS-DOS to look ahead one input character. 
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STATUS 

Command codes ~ 6 and 10 
STATUS - ES:BX -> 


| 13 -BYTE Request Header | 


All the driver must do is set the status word and the busy bit as follows: 

For output on character devices : If bit 9 is 1 on return, a write request (if 
made) would wait for completion of a current request. If it is 0, there is 
no current request and a write request (if made) would start immediately. 

For input on character devices with a buffer : A return of 1 means, a read 
request (if made) would go to the physical device. If it is 0 on return, 
then there are characters in the devices buffer and read would return 
quickly. A return of 0 also indicates that the user has typed something. 
MS-DOS assumes that all character devices have an input type-ahead buffer. 
Devices that do not have a type -ahead buffer should always return busy = 0 so 
that the DOS will not hang waiting for something to get into a buffer which 
doesn’t exist. 
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FLUSH Comnand codes * 7 and 11 
FLUSH - ES:BX -> 


| 13-BYTE Request Header 


The FLUSH call tells the driver to flush (terminate) all pending requests, 
call is used to flush the input queue on character devices. 


This 
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HP 150 INSTALLABLE DEVICE DRIVER EXAMPLE 


This is an example of an MSDOS installable device driver for the HP 150. As an 
MSDOS installable device driver, this example does nothing more than support the 
12 MSDOS command codes in name only, and does not attempt to implement their 
functions. The intention of the example is to outline the structure of an 
installable device driver. It is then a matter for the programmer to "fill in 
the blanks" to implement a functional driver. All device functions exist in 
name only, returning done status immediatly. 


. a*********************** I*********************************** a****************** 

9 


9 

; Driver's MSDOS Command Code Routines 


; Driver Routine’s Label Function of the particular routine 


; MSDOS COMMAND CODES: 

; MSDOS INITIALIZE 

; MSDOS~ MEDIA CHECK 

; MSDOS “ HUILITbPB 

; MSDOS" IGCTL INPUT 

; 1&D0S~ INPUT" 

; MSDOS" NON DSTHF INPUT 

; MSDOS" INPUT STATUS' 

; MSDOS~ INPUT" FLUSH 

; MSDOSJJUTPUT 

; MSDOS OUTPUT WITHJERIFI 

; MSDOSyUTFVTZSTATUS 

; MSDOS OUTPUT FLUSH 

; MSD0S~ IOCTLjOUTFUT 


Supported MDSOS Gourmand Codes 

0 - initializes the option into the system 

1 - performs media check on block devices 

2 - builds the device’s BIOS Parameter Block 

3 - performs an I/O control read from device 

4 - performs a normal destructive read 

5 - performs a non-destructive read , no wait 
8 - returns current input status of device 

7 - flushes the device’s input buffers 

8 ~ performs a normal output to the device 

9 - performs output with verify to the device 

10 - returns current output status of device 

11 - flushes the device’s output buffers 

12 - performs 10 control output to the device 


,* NOTE: All oomand code routines listed above exist in name only and simply 

; return status equal to done when called. 

9 

. &&**********&&********&*&**&****&&**&***#**********&*&**&***&***&****&&**&**** 
9 
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****************************************************************************** 


Start of the Installable Device Driver Routine 


; This next section starts the code segment for the rest of this module. 

CODS SEGMENT PUBLIC 'CODE' 

DRIVER PROC FAR 

ASSUME CS :CODE ,ES :CODE ,DS :CODE 

ORG 0 

BEGIN: 

START EQU $ 


9 

0 ******************* Jfr ****************************** **************************** 
9 

. *********£********£**********************&**&*********************&*******&*&& 
9 

9 

; MSDOS Installable Device Driver Header Format 


9 

; The foliating is the MSDOS installable device driver's device header. 

; This header must be at the beginning of each installable device driver. It 
; is used by the SI SIN IT module provided by Microsoft to link this installable 
; device driver into the system's device list. The format of this device header 
; is as foil mss: 


; 15 14 13 12 11 20 9 8 7 6 5 4 3 2 1 0 

; | offset of the MEET DEVICE DRIVER in the device list (-1 if last entry) | 

. - — — — — ~ + 

l | segment of the NEST DEVICE DRIVER in the device list(-l if last entry) | 

,* * _____ — — — ~+ 

; | ATTRIBUTES word describing device specific characteristics J 

. * _____ + 

i I offset to the device driver's STRATEGY routine | 

. 4—— — — — — — — — ____________ — — — — --f 

; | offset to the device driver’s INTERRUPT routine j 

; | 1st 2 bytes of a charac. dev. NAME , or § of UNITS for a block device \ 

. -f— — — — — — — + 

; | 2nd 2 bytes of a character device NAME , or nothing for a block device | 

; + - — — —————— + 

; | 3rd 2 bytes of a chacacter device NAME, or nothing for a block device | 

; i _______ — ________ + 

; | 4th 2 bytes of a character device NAME, or nothing for a block device | 

. + ------ + 

9 


* ******************** ************* ft ************ ***%•&***&**■?:*$:**%*■)*** it********** 
9 
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• ****************************************************************************** 
3 


3 

: Driver's Installable Device Driver Header 


; The device implemented by the driver is a simple character device 
; with an MSDOS strategy routine at DRIVER-STRATEGY and an K5D0S interrupt 
; routine at DRIVER-INTERRUPT . The name of this device is "DRIVER" . The 
; installable device driver header for this device is as follows: 


3 


NEXT DEVICE 

DD 

-1 

;link to next dev. a -l end of list 

ATTRIBUTES 

m 

08000H 

;8000H means a character device 

STRATEGY 

DM 

DRIVER STRATEGY 

;driver’ s STRATEGY routine entry 

INTERRUPT 

DM 

DRIVER INTERRUPT 

; driver ’ s INTERRUPT routine entry 

DEVICE NAME 

DB 

"DRIVER " 

; driver' s name is "DRIVER 1 


3 

. ****************************************************************************** 
3 


****************************************************************************** 
Driver's MSWS Corrmmd Code Routines Dispatch Table 


3 

; The following section contains a dispatch table that describes the entry 
; points for the routines that implement the various 12 MSDOS command codes for 
; this example device. This table is indexed into based on the MSDOS command 
; code in the request header, and a jimp is made to the address of the routine 
; listed in this table. The dispatch table of MSWS commxd codes for this 
; example driver is as follows: 


MSWSJ20MMAND CODES: 

m mms Initialize 

m MSWS_MEDIAjCHECK 
m MSWS~ WILDJ3PB 
DM MSDOS IOCTLJNHJT 
m MSDOS~ INPUT 
mi MSDOS" NON_DSTW INPUT 
m moos INPUT ^STATUS 
m MSDOSJNPUTJUJSH 
Of MSDOS_CUTPUT 
DM MSDOS _OUTFUT WITH VERIFY 
m MSWS -OUTPUT STATUS 

m moos output ' flush 

DM MSDOS~ IOCTL OUTPUT 


; Support MSDOS Command Codes (dispatch table) 

; 0 - initializes the driver into the system 
; 1 - performs media check on block devices 
; 2 - builds the device's BIOS Parameter Block 
; 3 ~ performs an I/O control read from device 
; 4 - performs a normal destructive read 
; 5 - performs a non-destructive read, no wait 
; 6 - returns current input status of device 
; 7 - flushes the device's input buffers 
; 8 ~ performs a normal output to the device 
; 9 - performs output with verify to the device 
;10 - returns current output status of device 
; 11 - flushes the device's output buffers 
; 12 - performs I/O control output to the device 


3 

• ****************************************************************************** 
3 
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.a***************************************************************************** 


MSDOS Bequest Header Format 


; This next section contains a template for the MSDOS request header. This 
; template is used to extract and update the necessary request header entries. 
; The MSDOS request header' 8 format is as shown below: 


4~ 




76S43210 

LENGTH of the request HEADER in bytes 
UNIT that this call is intended for 
COMMAND CODE or function mmiber 


driver’s RETURN STATUS , first of two 


driver’s RETURN STATUS , second of two 


********** 


********* 


********** 


mSSWED 


* It ft* ft*** it 


********** 


********** 


RESEWED 

RESEWED 


********* 


********* 


********** 


imSEWBD 


********** 


********* 


********* 


********** 


RESEWED 


********* 


********** 


********* 


****** ft 


Command Specific Data 


****** 


+ 

I 

+ 

+ 

I 

+ 

+ 

s 

+ 

! 

+ 

I 

+ 

I 

■f 

I 

+ 

1 

I 

+ 

I 

+ 

I 

"f 

I 


****** Command Specific Data ****** | 



• ****************************************************************************** 
3 
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v **************************** *************** *********************************** 
9 


9 

; Driver's MSDOS Bequest Header Structure 


; The BEQUEST JiEADER structure that this module wilt 'use to access the MSDOS 
; request header packet is defined as follows: 

9 

REQUEST JiEADER STHUC ; request header template structure 


HEADERJjEHGTH 
UNIT NUMBER 
COMMAND CODE 
RETURN JTATUS 
RESERVED 
MEDIA DESCRIPTOR 
TRANSFER ADDRESS 
COUNT 

STARTING SECTOR 


DB ? 

DB ? 

DB ? 

Of ? 

DB 8 DUP (?) 
DB ? 

DD ? 

m ? 
m ? 


; length of the request header 
; unit number for this request 
; request header's eonmand code 
;driver' 8 return status Word 
; ******* RESERVED ******* 

; media descriptor byte 
; transfer address 
; byte /sector count Value 
; starting sector value 


REQUEST 'JiEADER ENDS ;end of request header template 

9 

. ****************************************************************************** 
9 


• ****************************************************************************** 
9 


9 

; Driver's Local Variables 


HEADERJPOINTER DD ? ; pointer to the request header 


****************************************************************************** 


. ****************************************************************************** 
9 

9 

; DRIVER'S Local Constants 


9 

MAXJCOMMAHDJZODB EQU 012 ; MSDOS eemvmmd code lumber maximm 

9 

• ************************** **************************************************** 
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.ft***************************************************************************** 

3 


3 

; Driver’s MSDOS Device Driver Strategy Routine 


; This next section contains this driver ’ s strategy routine. This routine 
; is entered each time a request is made for this device. 

3 

; All requests for this device 

; first call its strategy routine and then its interrupt routine 
; The strategy routine is passed a pointer (in ES:BX) to the request header , 

; which it saves in a local Variable called HEADER_POINTER and then it returns 
; to the BDOS. Tltis exzimple device driver’s strategy routine is defined as 
; foliates: 

3 

; INPUTS ~ ES:BX points to the request header 

3 

; OUTPUTS - HEADER JPOIMEB points to the active request header 

3 

3 

3 

STRJ&BGYJPROCEffiRE PWC FAR ; beginning of strategy procedure 


DRIVER STRATEGY: ; strategy routine entry point 

MOV WORD PTR CS: [HEADER POINTER] ,3X ;save offset of request header 

MOV WORD PTR CS: [HEADElf POINTEW-2 ] ,ES ;save segment of request header 
RET ; return to the calling routine 


STRATEGY _PWCEDURE ENDP ;end of the strategy procedure 

3 

• &&&*&*&*&*&***&&***&********&****&&&&****&*&&*&&*&*&&**&*&&**&&*&**&&***&&&&&& 
3 


. ****************&***}:************** *********& ************ ft ******* ft**** ****** ft* 
3 


Driver’s MSDOS Device Driver Interrupt Routine 


; 2%is next section contains this driver's MSDOS interrupt routine. This 
; is the entry point that the BBSS will call immediately after 
; it has called this driver’s strategy routine. It is this routine's 
; responsibility to transfer control to the appropriate routine within this 
; module based on the cormand code found in the current request header. It 
; uses this command code as an index into its MSDOS command codes dispatch 
; table, to extract the address of the routine that can service the incoming 
; request. 

3 

; INPUTS - HEADER ^POINTER points to the recpuest header 

; OUTPUTS - REQUEST JlEADER / RETUM ^STATUS] set appropriately 

cosmand code specific data where specified 


3 
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****************************************************************************** 


’,R INTERRUPT: 

; device driver interrupt routine 
;save the caller's AX register 

PUSH 

AX 

PUSH 

BX 

;saoe the caller's BX register 

PUSH 

CX 

;saVe the caller’s CX register 

PUSH 

DX 

;saoe the caller’s DX register 

PUSH 

DS 

; save the caller’s DS register 

PUSH 

ES 

;save the caller’s IBS register 

PUSH 

DI 

;saVe the caller's DI register 

PUSH 

SI 

;save the caller’s SI register 

PUSH 

BP 

;save the caller’ s BP register 

These sections of code prepare the system's registers with the values 


found in the request header before transferring control to the appropriate 
routine. The registers are prepared as follows: 

M ■ AH— > MEDIA DESCRIPTOR/ AL—>UNIT NUMBER 

BX = OFFSET within IBS segment to the request header 

CX - COUNT ( bytes or sectors) of the data to ' ; >e read or written 

DX * STARTING SECTOR to be read or Written 

D1 = TRANSFER ADDRESS of user's buffer or data 

SI * address of the start of the servicing routine 

DS - data segment address of this driver ( same as CS) 

ES ~ segment address of the request header 


LDS BX,CS: [HEADER POINTER] 

MOV ALJBX.UNIT NUMBER] 

MW AH JBX. MEDIA DESCRIPTOR] 
M(W CX JBX. COUNT] 

MW DX, [BX. STARTING J5ECT0R] 

XCHG DI,AX 


; point DS:BX to the request header 
; load AL with the UNIT NUMBER 
;load AH with the MEDIA DESCRIPTOR 
;load CX with the COUNT value 
; load DX With the STARTING SECTOR 
; save AX in DI temporarily 


Extract the commnd code from the request header and branch to the 
appropriate routine within this module that can service it. 


MW AL , [BX. COMMANDJZODB ] 

XOR AH, AH 

CMP AL,MAX COMMAND JCODB 
JG COMMAND CODE ERROR 
SHL AL,1 

MW SI, OFFSET MSDOS COMMAND CODES 

ADD SI, AX 

XCHG AX,DI 

LES DI JBX. TRANSFER JIDDmSS] 

PUSH CS 
POP DS 

JMP WORD PTR [SI] 


;load AX with the COMMAND CODE 
; clear off the high byte of AX 
;is this a legal ccmncmd code? 

;if no, then error out here 
; convert byte to word pointer 
; point SI to MSDOS dispatch table 
; index SI to the desired routine 
;restore AX from DI temp, storage 
; point DI to transfer addr. offset 
; place code segment on the stack. . 
;then point DS to the axle segment 
;jurnp to the appropriate routine 


9 

• ft ft •k’drkfi frit ft it ft it Irk ft ft flit* & it It it it irk "kirk It frit ft hit 
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****************************************************************************** 
Driver's MSDOS Ccmrand Code General Purpose Routines 

These are a set of general purpose routines that are used by all 
of the MSDOS comand code routines. 


COMMAND CODE ERROR: 


EXIT: 


MOV 

AL,3 

MOV 

AH, 1000000 13 

JMP 

EXITjmiVER 

MOV 

AH , 0000000 IB 


;AL*3 means bad command code error 
; AH* error and done hits set 
l exit driver through EXIT_DRIVER 


;M*no errors occured this time 
;drop through to exit the driver 

*****&&&&******&****&*****&*****&***&*&&&***&*&&**&******&**&&**&&*&&&»**&&**& 


• ***#****&*&***&&**&&***&*&&*&**#****&&*&&&&**»*****&&&****&**&***********&*&&& 
9 


9 

; Driver's MSDOS Camsznd Code Exit Routine 


; This procedure is used to generate a long return to the caller. 

; The Value passed to this routine in AX is placed in the 

; RETURN JsTATUS Word entry of the pending request header. Then this routine 
; restores the stack back to the state it Was when this driver was originally 
; called, and then returns to the caller. 


; INPUTS - AX contains the EETUM_STJffiJS value for the 

; pending I/O request . 


9 

9 


EXITJPROC PWC FAR 

EXIT DRIVER: 

~LDS BX,CS: [HEADER POINTER] 

MOV DS:[BX.RETUM~ STATUS], AX 

POP BP 

POP SI 

POP DI 

POP ES 

POP DS 

POP DX 

POP CX 

POP BX 

FOP AX 

RET 


•point BX to the request header 
;set the STATUS word accordingly 
; restore the caller's BP register 
; restore the caller's SI register 
; restore the caller's DI register 
;restore the caller’s ES register 
; restore the caller' s DS register 
;restore the caller's DX register 
; restore the caller's CX register 
; restore the caller’ s BX register 
; restore the caller's AX register 
;return to caller BDOS 


EXITPWC ENDP 

9 

• ****. ********** **&Ar?***** ******* ****** ****** *********^** ************ *********** 
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****************************************************************************** 
Driver's MSDOS Comand Code Routines 


; The MSDOS Cotrmmd Code Routines do nothing other than exit with the 
; RETURN JSTATUS word in the request header set to done without errors. 

MSDOS _MEDIA_CHECK: ; MSDOS Cormrmd Code # 1 

NOP ;code to process MEDIA CHECK 

JMP BUT to the EXIT routine 

MSDOS JUILDJSPB: ; MSDOS Command Code # 2 


MOP 

JMP MIT 

;code to process WILD BPS 
ljump to the EXIT routine 

MSDOS IOCTL INPUT: 
MOP 

JMP EXIT 

; MSDOS Comand Code # 3 
;code to process IOCTL INPUT 
ijw to the EXIT routine 

MSDOS INPUT: 

NOP 

JMP EXIT 

; MSDOS Comand Code § 4 
;code to process INPUT 
ijump to the exit routine 

mws NON DSTW INPUT: 
MOP ~ 

JMP EXIT 

; MSWS Command Code # 5 
; code to process NON DSTW INPUT 
• jisnp to the exit routine 

MSDOS INPUT STATUS: 
NOP 

JMP EXIT 

;MSWS Comand Code # 6 
; code to process INPUT STATUS 
ljump to the EXIT routine 

mWS INPUT FLUSH: 
NOP 

JMP EXIT 

iMSDOS Comand Code # 7 
icode to process INPUT PLUSH 
ljump to the EXIT routine 

mws OUTPUT: 

NOP 

JMP EXIT 

;MSWS Command Code # 8 
icode to process OUTPUT 
ljump to the EXIT routine 

MSWS OUTPUT WITH VERIFY: 
NOP 

JMP EXIT 

; MSDOS Command, Code # 9 

;code to process OUTPUT W /VERIFY 

l/jump to the EXIT routine 

MSWS OUTPUT STATUS: 
NOP 

JMP EXIT 

; mWS Comand Code 810 
icode to process OUTPUT STATUS 
ijtenp to the EXIT routine 

MSDOS OUTPUT FLUSH: 
NOP 

JMP EXIT 

iMSWS Comand Code ill 
icode to process OUTPUT FLUSH 
ijtsnp to the EXIT routine 
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MSDOS IOCTL OUTPUT: 
NOP 

JMP EXIT 


; MSDOS Command Code §12 
;code to process IOCTL OUTPUT 
;jump to the EXIT routine 


MSDOS JNITIALIZE: ; MSDOS Command Code 00 

LDS BX ,CS: [ HEADER POINTER] ; point DS:BX to the request header 

MOV WORD PTR DS:[BX. TRMSFER_ADDRESS ] , OFFSET MSDOS INITIALIZE 

MOV WORD PTR DS: [BX. TRANSFER ADDRESS+2] ,CS 

JMP EXIT 


DRIVER ENDP 
# 

CODE ENDS 

END START 
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AGIOS: I/O CONTROL OF THE CON DEVICE 


The Alpha/Graphic Input/Output System (AGIOS) 

The Alpha/Graphic I/O system is a set of functions which can be called from 
application programs. The functions help programmers manipulate the HP 150 
video display, control the touchscreen, and handle the keyboard. The AGIOS 
functions provide a high level interface to these entities sparing the 
programmer of much tedium which may otherwise be necessary. The price which is 
sometimes paid for this convenience is performance. For this reason. Section 7* 
Programming the HP 150, includes some information allowing programmers access to 
the alpha and graphics memories in a direct manner. 


Accessing the AGIOS 

The Alpha/Graphic I/O System is implemented as a set of functions which are 
really MS-DOS System Function Call sub-functions . MS-DOS includes a function, 
I/O control for devices (function 44H) . This function enables an IOCTL device 
command to an open device to be performed. The IOCTL function can be 
implemented by a device driver to 

allow control-type manipulation of the device, rather than read/write oriented 
operations. The HP 150 console device "CON" implements the AGIOS function set 
through its IOCTL call. 

Most high level programming languages on the HP 150 do not allow direct 
manipulation of the 8088 registers. To perform an MS-DOS System Function and 
hence, an AGIOS function, the registers must be loaded with function-dependent 
data. As a result, AGIOS function calls from high level languages are usually 
made through assembly language subroutines combined with the higher level code 
at link time. 

The following code is an example of am AGIOS function call written in assembly 
language. It is the "Execute Two Character Escape Sequence" AGIOS function. 

This AGIOS function call requires a three byte buffer which contains the 
function code followed by the "J" parameter. 

+ + + .-+ 

BUFF | 16 | 0 | J | 

+ + + + 

Byte: +0 +1 +2 

Tiie program segment to accomplish the clear display would look something like 
this in assembler: 
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clrscm 


huff 


LABEL BEAR 
MOV AX,4403H 
MOV BX,1 
MOV CX,3 

MOV DX, OFFSET buff 

INT Z1H 

RET 

DB 16,0, 'J' 


',1/0 Control Write 
;Console Handle, always ~ 1 
;buff length (3 in this case) 
;and Offset 
; MS-DOS call 


The above example lacks elegance and structure typical of good programming 
practice. For example, the buffer could reside in the data segment and be 
accessible such that other escape sequences could be programmed. Or the 
function dependent argument ("J” in this case) could be passed on the stack. 
Nor does the above routine do any error checking. If am MS-DOS error occurs 
when you make an AGIOS function call, the "carry flag" is set according to the 
standard MS-DOS procedures. If am AGIOS error occurs, the AX register contains 
a non-zero value. AGIOS errors can occur when MS-DOS errors do not occur. This 
means that the carry flag is not set but the AX register contains a non-zero 
character. Therefore, you need to check both of these indicators after a 
function call to determine if the operation was completed successfully. 


For more information on making AGIOS and MS-DOS calls from high level languages, 
together with some more generalized examples, refer to Section 7, Programming 
the HP 150. 
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BIOS AND ITS DEVICES 


Introduction 

The HP 150 *s Basic I/O System (BIOS) consists of a set of twelve modules that 
are responsible for interacting with Microsoft’s Basic Disc Operating System 
(EDOS) on one side, and with the HP 150 firmware routines on the other. The 
interface between the BDOS and the BIOS is specified by Microsoft, and the HP 
150’s BIOS modules implement this interface. (See "Calling a Device Driver" 
earlier in this section.) However, to perform the actual I/O operations they 
rely heavily on the services provided by the firmware. Much of what these 
modules do is to take function calls handed down from the BDOS, translate them 
into appropriate firmware calls, and call the firmware routines to execute the 
I/O function. 

CONSOLE DEVICE 

Device Names : CON 

Device Functions Implemented: 

0 
1 
2 

3 

4 

5 

6 

7 

8 
9 

10 
11 
12 


INIT Not implemented 

MEDIA CHECK Not implemented 

BUILD BPP Not implemented 

I0CTL INPUT Reserved - returns error 

INPUT (read) Valid 

NON-DESTRUCTIVE INPUT NO WAIT Valid 

INPUT STATUS Not implemented 

INPUT FLUSH Valid 

OUTPUT (write) Valid 

OUTPUT (write) WITH VERIFY ... Valid 

OUTPUT STATUS Not required by firmware 

OUTPUT FLUSH Valid 

IOCTL OUTPUT Valid - AGIOS 
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SERIAL DATA COMMUNICATIONS DEVICES 


Device Names: 

COM, C0M1, COM2, FRN, LST, AUX, PLT, LPT1, LPT2, LPT3 


Device Functions Implemented: 


0 INIT 

1 MEDIA CHECK 

2 BUILD BPP 

3 XOCTL INPUT 

4 INPUT (read) 

5 NON-DESTRUCTIVE INPUT NO WAIT 

6 INPUT STATUS 

7 INPUT FLUSH 

8 OUTPUT (write) 

9 OUTPUT (write) WITH VERIFY . . . 

10 OUTPUT STATUS 

11 OUTPUT FLUSH 

12 IOCTL OUTPUT 


Not implemented 
Not implemented 
Not implemented 

Valid - returns on buffer empty 

Valid 

Valid 

Not implemented 
Valid 

Valid 


Valid 

Valid 


Not implemented 
Valid 


TIME DEVICE 


Device Name: 
CLOCK 


Device Functions Implemented: 

0 INIT 

1 MEDIA CHECK 

2 BUILD BPP 

3 IOCTL INPUT 

4 INPUT (read) 

5 NON-DESTRUCTIVE INPUT NO WAIT 

6 INPUT STATUS 

7 INPUT FLUSH 

8 OUTPUT (write) 

9 OUTPUT (write) WITH VERIFY ... 

10 OUTPUT STATUS 

11 OUTPUT FLUSH 

12 IOCTL OUTPUT 


Not implemented 

Not implemented 

Not implemented 

Reserved - retains an error 

Valid 

Not implemented - returns busy flag 

Not implemented 

Not implemented 

Valid 

Valid 

Not implemented 
Not implemented 
Not implemented 
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INTEGRAL PRINTER DEVICE 


Device Names: 

INT, PRN, AUX, LST, LPT1, LPT2, LPT3 


Driver Functions Implemented: 


0 INIT 

1 MEDIA CHECK 

2 BUILD BPP 

3 IOCTL INPUT 

4 INPUT (read) 

5 NON-DESTRUCTIVE INPUT NO WAIT 

6 INPUT STATUS 

7 INPUT FLUSH 

8 OUTPUT (write) 

9 OUTPUT (write) WITH VERIFY ... 

10 OUTPUT STATUS 

11 OUTPUT FLUSH 

12 IOCTL OUTPUT 


Not implemented 

Not implemented 

Not implemented 

Reserved - returns an error 

Valid 

Not implemented - returns an error 

Not implemented 

Not implemented 

Valid 

Valid 

Valid 

Not implemented 
Not implemented 


DISC, HPIB PRINTER, HPIB PLOTTER DEVICES 
Device Names : 

A: L:, AUX, PRN, LST, PLT, LPT1, LPT2, LPT3 


Driver Functions Implemented: 

0 INIT 

1 MEDIA CHECK 

2 BUILD BPP 

3 IOCTL INPUT 

4 INPUT (read) 

5 NON -DESTRUCTIVE INPUT NO WAIT 

6 INPUT STATUS 

7 INPUT FLUSH 

8 OUTPUT (write) 

9 OUTPUT (write) WITH VERIFY ... 

10 OUTPUT STATUS 

11 OUTPUT FLUSH 

12 IOCTL OUTPUT 


Not implemented 

Not implemented 

Not implemented 

Reserved - returns an error 

Valid 

Not implemented - returns busy flag 

Not implemented 

Not implemented 

Valid 

Valid 

Valid 

Not implemented 
Not implemented 
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HPIBDEV DEVICE 
Device Name: 
HPIBDEV 


Driver Functions Implemented: 

0 INIT 

1 MEDIA CHECK 

2 BUILD BPP 

3 IOCTL INPUT 

4 INPUT (read) 

5 NON-DESTRUCTIVE INPUT NO WAIT 

6 INPUT STATUS 

7 INPUT FLUSH 

8 OUTPUT (write) 

9 OUTPUT (write) WITH VERIFY . . . 

10 OUTPUT STATUS 

11 OUTPUT FLUSH 

12 IOCTL OUTPUT 


Not implemented 
Not implemented 
Not implemented 
Special HP data returns 
Not implemented 

Not implemented - returns busy flag 

Not implemented 

Hot implemented 

Valid 

Valid 

Valid 

Not implemented 

Valid - pass through of template & data 
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THE CONFIG.SYS FILE 


In many cases, there are installation-specific configurations of the operating 
system that are needed to be set up at boot time. The user need not re-build 
the DOS (BDOS) to include special drivers or to 

include a particular number of device drivers. Drivers for additional devices 
may be included as separate entities. See the discussion of devices earlier in 
this chapter. The configuration file allows a user to configure his system 
without extra work. 

The configuration file is simply an ASCII file that has certain commands for the 
operating system initialization task. 

During operating system initialization (booting) a long jump to the SYSINIT 
routine in the BIOS SYSINIT module is made. This module (supplied with the 
operating system from Microsoft) will initialize the DOS and read the 
configuration file CONFIG.SYS, if it exists, to perform device installation and 
various other user settable things. 

The following are a list of commands for the configuration file CONFIG.SYS: 
BUFFERS * <rwmber> 

This is the number of additional sector buffers to add to the system list. 
The effect of several BUFFERS commands is to allocate a series of buffers. 
The default is BIOS specific, equal to 1 6 in versions A. 01. 02 and A.01.06. 
The minimum value allowed for BUFFERS is one. With Winchester disc based 
systems, performance may be improved by increasing the buffer or size so as 
to allow the entire disc FAT (File Allocation Table) into buffer memory. As 
such, the operating system can access the entire FAT without going to disc. 

FILES 3 < member* 

This is the number of open files that the XENIX system calls can access. The 
default is BIOS specific, equal to 20 in versions A. 01. 02 and A.01.06. If a 
number less than or equal to five is specified, the command is ignored. 

DEVICE 3 < filename > 

This installs the device driver in <f ilename> into the system list. 

BREAK 3 <ON or OFF> 

If ON is specified (the default is OFF), a check for ’C at the console input 
will be made every time the system is called. ON improves the ability to 
abort programs over previous versions of the DOS. 

S&ITCHAR 3 < chary 

Causes the DOS to return <char> as the current switch designator character 
when the DOS call to return the switch character is made. Default is ’/’. 
Note that the setting of SWITCHAR may effect characters used on the SHELL 
line (this is true of COMMAND.COM) . 

AVAILDEV 3 <TWE or PALSE> 

The default is TRUE which means both /dev/<dev> and <dev> will reference the 
device <dev>. If FALSE is selected, only /dev/<dev> refers to device <dev>. 
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<dev> by itself means a file in the current directory with the same name as 
one of the devices. 

SHELL ■ < filename > 

This begins execution of the shell (top-level command processor) from 
<filename>. Note that the parameters on this line are shell dependent. 


A typical configuration file might look like this: 

BUFFERS » 10 
FILES = 10 

DEVICE ■ fbin/nettfork. sys 

BREAK - ON 

SHITCHAR * - 

SHELL ■ pamaode. exe root 
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DISC FORMAT AND DIRECTORY STRUCTURE 


Physical Disc Format 

HP 150 disc media are partitioned physically into "tracks" which 

in turn are each partitioned into "sectors". Each sector is a physical portion 

of a track commonly containing 256 bytes of information. 

Sectors are numbered 0, 1, 2, 3, and so on. This is not to say that 

sector 1 follows sector 0 physically on the disc. Sector "staggering" is 
employed to improve disc read and write efficiency. 

The disc drive takes care of logical to physical mapping and as such the 
programmer need only be concerned with logical sector numbering, above. 


Disc Media Storage Capacity 

The following table shows the storage capacity in sectors and number of 
kilobytes for different types of disc drives available on the HP 150. 

Total Total 

Media Type Sectors KB 


3-1/2" Single Sided Microfloppy 

1,056 

264 

3-1/2" Double Sided Microfloppy 

1,385 * 

709 

5-1/4" Double Sided Minifloppy 

1,056 

264 

8 " Floppy (HP Format) 

4,500 

1,125 

8 " Floppy (IBM Format) 

2,002 ** 

250 

"5MB" Winchester 

18,848 

4,712 

"10MB" Winchester 

37,820 

9,455 

"15MB" Winchester 

56,730 

14,182 


* Sector size is 512 bytes. 

** Sector size is 128 bytes. 

All other media have 256 byte sectors . 
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Disc Sector Allocation 

Beginning with logical sector number 0, several contiguous sectors 
are reserved for system use, that is they do not contain file 
data. The sector map of a disc looks like this: 


Sector 

Number 

+ + 

0 | Header Record 


Contains 


Boot sector for operating system disc. FF’s for 
non-O.S. disc. 


2 -XX 


File Allocation Table (FAT) Number 1 


XX-XX 


File Allocation Table (FAT) Number 2 


XX-XX 


Disc Directory 


XX - 
Last 


Disc Data Area 


NOTE: The number of FAT, DIRECTORY and DATA sectors varies from media type to 
media type. 
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Header Record 

The header record contains disc dependent data. It is always the first logical 
disc record. The header record is structured as follows. 


ENTRY REFERS TO DISC TYPE 

| 3'' & V I 3" dbl. | RAM j T 

j single | sided j disc | 8" j 
========================+========+=====“=+========+========+ 

EBH, 1CH,90H (3 Bytes) | All discs contain this information! 

— + + + + + 


"HP150 " (8 Bytes)! All discs contain this information! 


bytes per sector 

(W)| 

-- + * 

256 | 

+ - 

512 | 

512 1 

256 

sectors per cluster 0 

<B)| 

4 1 

2 I 

1 1 

16 

reserved sectors 

(w)| 

2 ! 

2 I 

2 1 

2 

number of FATs 

(B) | 

2 I 

2 I 

1 1 

1 

number of DIR entries (W) | 

128 | 

128 | 

128 1 

256 

total sectors 

(W)| 

1,056 | 

1,385 1 

** l u 

,500 

media type = FAH 

(B)| 

T T 

All discs use 

this value 


sectors per FAT 

(w)i 

3 i 

3 i 

3 1 

3 

sectors per track 

(W)| 

16 I 

8 1 

_ r T ^ . 
NA i 

30 

number of heads 

(W)| 

2 I 

2 1 

NA | 

2 

# of hidden sectors 
= 00H 

1 

(W)| 

4-- 

All 

discs use 

— — — — — — — — — — 
this value 
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ENTRY REFERS TO DISC TYPE 



— r 
1 

5 MB 

T 

1 

10 MB 

T 

1 

15 MB 

i 

| IBM 8“ 

EBH, 1CH , 90H (3 Bytes )1 

All discs 

: contain 

this information 

"HP150 " (8 Bytes )| 

All discs 

' contain 

this information 

bytes per sector 

(W)| 
... . 

256 

1 

.X. 

256 

T 

1 

.X. 

256 

1 

.x.« _ » 

128 

sectors per cluster # 

(B) | 

16 

1 

16 

1 

16 

1 

8 

reserved sectors 

(W)| 

2 

■T“ 

1 

2 

“T “ 

1 

2 

1 

1 

number of FATs 

(B) ! 

2 

*T“ 

1 

2 

*T* 

1 

2 

’T“ — — - 
1 

2 

number of DIR entries (W) | 

1,024 

1 

1,024 

* V * 

1 

1,024 

1 

68 

total sectors 

(W)| 

8,848 

m 'T mm 

1 

37,820 

~’V ■ 
1 

56,730 

1 2, 

,002 

media type = FAH 

(B)| 

V T 

All discs use 

— T 

this value 


sectors per FAT 

(W)| 

9 

1 

15 

T 

1 

21 

1 

6 

sectors per track 

(W)| 

31 

■T“ 

1 

31 

“T “ 
1 

31 

1 

26 

number of heads 

(W) | 

4 

1 

4 

*T* 

1 

6 

*T“" **■ * 
1 

1 

# of hidden sectors 
= 00H 

1 

(W)| 

— -4. 

All 

discs use this value 



* Also referred to an an allocation unit . 
** Size specified in the DEVCONFG utility. 
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Boot Sector 

The boot sector holds an index to other sectors which contain the operating 
system code (MS-DOS). During system initialization, the firmware reads in the 
code from the sectors indexed by the boot sector. If the disc is a 
non-operating system disc, this sector contains FF’s. 

The format of the boot sector of a disc containing an operating system is as 
follows . 


Number of sectors to Read 

(WORD) 

Absolute Disc Sector Number to Load From 

(WORD) 

Memory Address to Load Into (Offset) 

(WORD) 

Memory Address to Load Into (Segment) 

(WORD) 

(contiguous) 

Number of Sectors to Read 

(WORD) 

Absolute Disc Sector Number to Load From 

(WORD) 

Memory Address to Load Into (Offset) 

(WORD) 

Memory Address to Load Into (Segment) 

(WORD) 

(contiguous) 


(contiguous) 

FFFFH (Extent Terminator) 

(WORD) 

Execution Starting Address (Offset) 

(WORD) 

Execution Starting Address (Segment) 

(WORD) 


+ 

I 

I 

first | 
extent | 

I 

I 

I 

— + 

+ 

I 

I 

second | 
extent | 

I 

I 

I 

+ 

+ 

n’th | 
extent | 
+ 


Note: The second through n’th extents may not exist. 
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File Allocation Table (FAT) 


DISC CLUSTERS 

Disc sectors are grouped together into what are known as "clusters". On a 3 
1/2" flexible disc, there are four sectors per cluster. Files are assigned 
space on the disc in increments of 1 cluster. That is for a 3 1/2" disc files 
are built in one kilobyte pieces. 

The File Allocation Table is an area partitioned into many one and one half byte 
(12 bit) entries, each representative of a particular cluster. A file’s 
directory entry contains a starting cluster number. The FAT entry corresponding 
to this cluster will point to another cluster, being the second cluster of the 
file. Hie FAT entry corresponding to this second cluster will point to a third 
cluster and so on. That is, the FAT entries describe a linked list of clusters 
containing the file. 


FAT STRUCTURE The File Allocation Table always begins on the first section 
after the reserved sectors. If the FAT is larger than one sector, the sectors 
are contiguous. Two copies of the FAT are usually written for data integrity. 
The FAT is read into one of the MS-DOS buffers whenever needed (open, read, 
write, etc.). The File Allocation Table is an array of 12-bit entries (1.5 
bytes) for each cluster on the disk. The first two FAT entries map a portion of 
the directory; these FAT entries indicate the size and format of the disk. 

The second and third bytes currently always contain FFH. 

The third FAT entry, which starts at byte offset 4, begins the mapping of the 
data area (cluster 002). Files in the data area are not always written 
sequentially on the disk. The data area is allocated one cluster at a time, 
skipping over clusters already allocated. The first free cluster found will be 
the next cluster allocated, regardless of its physical location on the disk. 
This permits the most efficient utilization of disk space because clusters made 
available by erasing files can be allocated for new files. 

Each FAT entry contains three hexadecimal characters: 

000 If the cluster is unused and available. 

FF7 The cluster has a bad sector in it. MS-DOS 

will not allocate such a cluster. CHKDSK cotints 
the number of bad clusters for its report. 

These bad clusters are not part of any allocation 
chain. 

FF8-FFF Indicates the last cluster of a file. 

XXX Any other characters that are the cluster number 

of the next cluster in the file. The cluster 
number of the first cluster in the file is kept 
in the file’s directory entry. 
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HOW TO USE THE FILE ALLOCATION TABLE The following information is included 
for system programmers who wish to write installable block device drivers • This 
section explains how MS-DOS uses the File Allocation Table to convert the 
clusters of a file to logical sector numbers. The driver is then responsible 
for locating the logical sector on disk. Programs must use the MS-DOS file 
management function calls for accessing files; programs that access the FAT are 
not guaranteed to be upwardly -compatible with future releases of MS-DOS. 

Use the directory entry to find the starting cluster of the file. Next, to 
locate each subsequent cluster of the file: 

1. Multiple the cluster number just used by 1.5 (each FAT 
entry is 1.5 bytes long). 

2. The whole part of the product is an offset into the FAT 
pointing to the entry that maps the cluster just used. 

That entry contains the cluster number of the next 
cluster of the file. 

3. Use a MOV instruction to move the word at the calculated 
FAT offset into a register. 

4. If the last cluster used was an even number, keep the 
low-order 12 bits of the register by ANDing it with FFF; 
otherwise, keep the high-order 12 bits by shifting the 
register right 4 bits with a SHR instruction. 

5. If the resultant 12 bits are FF8H-FFFH, the file contains 
no more clusters. Otherwise, the 12 bits contain the 
cluster number of the next cluster in the file. 

To convert the cluster to a logical sector number (relative sector, such as that 
used by Interrupts 25H and 26H and by DEBUG) : 

1. Subtract 2 from the cluster number. 

2. Multiply the result by the number of sectors per 
cluster. 

3. Add to this result the logical sector number of the 
beginning of the data area. 

MS-DOS Disc Directory 

The disc directory is a list of all files residing on the disc. The FORMAT 
program builds the root directory for all disks. Its location on disk and the 
maximum number of entries are dependent on the media. 

Since directories other than the root directory are regarded as file by MS-DOS, 
there is no limit to the number of files they may contain. 

All directory entries are 32 bytes in length, and are in the following format 
(note that byte offsets are in hexadecimal): 
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0-7 Filename. Eight characters, left aligned and padded, 
if necessary, with blanks. The first byte of this 
field indicates the file status as follows: 

00H The directory entry has never been used. This is 
used to limit the length of directory searches, 
for performance reasons. 

2EH The entry is for a directory. If the second byte 
is also 2EH, then the cluster field contains the 
cluster number of this directory’s parent directory 
(0000H if the parent directory is the root 
directory). Otherwise, bytes 01H through OAH are 
all spaces, and the cluster field contains the 
cluster number of this directory. 

E5H The file was used, but it has been erased. 

Any other character is the first character of a 
filename. 

8-OA Filename extension 

OB File attribute. The attribute byte is mapped as follows 

(values are in hexadecimal) : 

01 File is marked read-only. An attempt to open the 
file for writing using the Open File system call 
(Function Request 3DH) results in an error code 
being returned. This value can be used along 
with other values below. Attempts to delete the 
file with the Delete File system call (13H) or 
Delete a Directory Entry (4lH) will also fail. 

02 Hidden file. The file is excluded from normal 
directory searches. 

04 System file. The file is excluded from normal 
directory searches. 

08 The entry contains the volume label in the 

first 11 bytes. The entry contains no other 
usable information (except date and time of 
creation), and may exist only in the root 
directory. 

10 The entry defines a sub-directory, and is 
excluded from normal directory searches. 

20 Archive bit. The bit is set to "on" whenever 
the file has been written to and closed. 

Note: The system files (10. SYS and MSDOS.SYS) 
are marked as read only, hidden, and system 
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files. Files can be marked hidden when they 
are created. Also, the read-only, hidden, system, 
and archive attributes may be changed through 
the Change Attributes system call (Function 
Request 43H). 

OC-15 Reserved. 

16-17 Time the file was created or last updated. The hour, 

minutes, and seconds are mapped into two bytes as follows: 

4 - --- +--- + 

| offset 15H | offset l4H | 

I I I 

I 15 14 13 12 11 10 9 8 | 7 6 5 4 3 2 1 0 | 

| - f---+ + + + | + -- -4 -4* j — - - 4* 4 +- — -4 — - J 

|Y|Y|Y|Y|Y|Y|Y|M|M|M|M|D|D|D|D|D| 

| + 4 . + f + 4 —-- j 4 - — | + 4 - 4- 4- 1 

| year | month | day of month | 

where: 

H is the binary number of hours (0-23) 

M is the binary number of minutes (0-59) 

S is the binary number of two second increments 

18-19 Date the file was created or last updated. 

The year, month, and day are mapped into two bytes 
as follows: 

- - ~ --- 4------ + 

| offset 17H | offset l6H | 

I I I 

| 15 14 13 12 11 10 9 8 | 7 6 5 4 3 2 1 0 | 

| — ^ ^ — j . — + ~ + .. _ _ __ 4- j — — 4. — | 

I H | H | H | H | H | M | M | M | M | M | M j 8 | S | S | S | S I 

| ~ 4, ~ ~ ~ + 4. | --- 4 * 4 * + --- + | 1 1- 1- | 

| hour | minute | second | 

where : 

Y is 0-119 (1980-2099) 

M is 1-12 
D is 1-31 

1A-1B Starting cluster; the cluster number of the first 
cluster in the file. 

Mote that the first cluster for data space on all disks 
is cluster 002. 

The cluster Number is stored with the least significant 
byte first. 
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MOTE 


Refer to section "How to Use the File Allocation 
Table," for details about converting cluster 
numbers to logical sector numbers . 

1C -IF File size in bytes. The first word of this four-byte field 

is the low order part of the size. 
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The HP 150 system contains a large amount of system management code located in 
Read Only Memory. In general, the firmware is not designed to be utilized by 
system programmers. The operating system BIOS serves as the interface to 
firmware located functionality. 

The HP 150 firmware is a rather complex multi-tasking operating system in 
itself. MS-DOS runs on the firmware as a single task from the firmwares 
perspective. Essentially all of the terminal functionality of the HP 150 is 
implemented in the firmware. The firmware implements much of the BIOS device 
driver functionality in addition to the terminal personality. 

This section details the firmware’s useage of the 2 6 K Byte of system RAM which 
it claims, and includes a table of the firmware entry points, vectors located 
within a portion of that memory. 
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Firmware Entry Point Jump Vectors 
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FIRMWARE MEMORY MAP 


RAM 

Portion of the system RAM memory is reserved for the use of the firmware. The 
following shows how that address space is allocated. 

Start of MS-DOS BIOS 

06800H + + 

I I 

| System Messages | 

I I 

01560H + + 

I I 

| Firmware Data Area | 

I (RESERVED - DO NOT MODIFY) j 

I I 

00580H + + 

I I 

| Firmware Entry Point Jump Vectors | 

I I 

00U00H + + 

Top of Interrupt Vector Table 


FIRMWARE ENTRY POINT JUMP VECTORS 

The firmware is highly structured, consisting of many tasks drivers, and 
software processors. Long calls may be made to these entities through vectors 
located in an area of firmware RAM. In general, each entry point detailed in 
the table below has a defined set of functions and parameter passing conventions 
for those functions. Programs should not call these functions, except when 
implementing operations as described in section 7 of this manual, Programming 
the HP 150. Access to the firmware entry points (located in ROM) should at all 
times be made through the following jump vectors. 


6-1 



System Firmware 


Address 

Vector to: 

Length (bytes) 




00400H 

System timer for MS-DOS | 4 


and applications 

1 

00420H 

THP ENTRY 

1 5 

00425H 

DHP ENTRY 

1 5 

0042AH 

DHP DRIVER 

1 5 

0042FH 

MMP ENTRY 

1 5 

00434H 

STP ENTRY 

1 5 

00439H 

IWP ENTRY 

1 5 

0043EH 

PHP ENTRY 

1 5 

00443H 

PAP ENTRY 

1 5 

00448H 

PAP PARSE 

1 5 

0044DH 

PAP PERFORM 

1 5 

00452H 

DTP ENTRY 

1 5 

00457H 

VCP ENTRY 

1 5 

0045CH 

CNP ENTRY 

1 5 

00461H 

DMP ENTRY 

1 5 

00466H 

WMP ENTRY 

i 5 

0046BH 

KBP ENTRY 

1 5 

00U70H 

DCP ENTRY 

1 5 

00475H 

RSP ENTRY 

1 5 

0047AH 

UTP ENTRY 

1 5 

0047FH 

NVRP ENTRY 

1 5 

00484H 

GSP ENTRY 

1 5 

00489H 

BMP ENTRY 

1 5 

0048EH 

STGP ENTRY 

1 5 

00493H 

HPSP ENTRY 

1 5 

00498H 

skp^entry 

1 5 

0049DH 

SVlf ENTRY 

1 5 

004A2H 

SLP ENTRY 

1 5 

004A7H 

GRP ENTRY 

1 5 

004ACH 

GRP TKPARSE 

i 5 

004B1H 

TSP ENTRY 

1 5 

004B6H 

TPM SKP ENTRY 

1 5 

004BBH 

IHP ENTRY 

1 5 

004C0H 

OHP ENTRY 

1 5 

oo4c5H 

OHP OPTION 

1 5 

004CAH 

VAU EXTERNAL DRIVER 1 5 

004CFH 

WMP ENTRY 

1 5 

004D4H 

KBT ENTRY1 

1 5 

004D9H 

KBT ENTRY 2 

1 5 
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This section is intended as an aid to programmers wishing to write applications 
programs to run on the HP 150. The HP 150 includes many system level functions 
intended to ease the complexity of programs running on the machine. Some of the 
examples included in this section demonstrate the use of these facilities. 

In some cases the functions provided, particularly in the area of video 
interfacing, may not provide acceptable performance levels for your application. 
For this reason the internal video structure of the HP 150 is described. The HP 
150 ’s built-in capabilities in the area of data communi cat ions are extensive. 
Information is included in this section to allow a programmer to take advantage 
of some of these capabilities. Finally, the HPIB interface on the HP 150 is 
described from an applications program standpoint. The discussion and 
corresponding examples show how to drive this interface and as such extend the 
capabilities of the HP 150 even further. 
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GENERATING ESCAPE SEQUENCES 


From the Microsoft C Language for example, a formatted print function (from the 
Microsoft C Library) may be used to send an escape sequence to the console 
escape sequence processor. Note that in the following example the string is 
terminated by cariage return and linefeed characters to cause the console output 
buffer to be "flushed", that is have the information actually processed. 

# define BSC OxlB 

main( ) 

l 

print f ( "%c&al2c2T\r\n" , BSC ); 

) 


The above example moves the cursor to row 2, column 12 in the currently 
displayed screen window. 


caution] 


Because AGIOS calls are processed immediatiy the call is issued and escape 
sequences are not processed until the console buffer is flushed, mixing the two 
without flushing the console buffer prior to making the AGIOS call may result in 
the AGIOS call being processed first. 
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PERFORMING MS-DOS SYSTEM FUNCTION CALLS 


From the Microsoft C Language for example, MS-DOS System Function calls are most 
easily made through an assembly language routine combined with the C object at 
link time. The following is an example of a general purpose System Function 
call written in assembly language. It is actually an assembly language coding 
of a Microsoft C compatible function. The function, when called with the 
appropriate parameters, can invoke almost any MS-DOS System Function. 
Parameters are passed on the stack. Note that since parameter passing 
conventions between routines vary from language to language, this function is 
particular to Microsoft C. 


; doscall ( ax, bx, cx , dx ) 
; int ax, bx, ox, dx; 


; Issues an MS-DOS System Function Call with registers passed in using 
; Microsoft C parameter passing contention and registers passed out in 
; global four vjord variable. 


Parameters in: 

ax - Value to put 
bx - Value to put 
cx - Value to put 
dx - Value to put 


in register AX 
in register BX 
in register CX 
in register DX 


; Return Value : 

; 1 ( boolean TRUE) - Carry flag was set by function ( error for same f'ns ) 

; 0 (boolean FALSE) - Carry flag not set by function (no error) 


9 

; Parameters out: 

; Registers AX, BX, CX, and DX are returned as four contiguous words 
; in global variable ’dc_ret' (which is defined by this routine) 

; Word 1 - AX register retixmed by function 

; Word 2 - BX register returned by function 

; Word 3 - CX register returned by function 

; Word 4 - DX register returned by function 


TRUE 

EQU 

1 

; Boolean true for return value 

FALSE 

EQU 

0 

; Boolean false for return value 

dcjxrgs 

STRUC 


; Stock structure for passed parameters 


DW 

7 

; Callers BP 


DW 

7 

; Return address 

axin 

DW 

7 

; 'ax' 

bx_in 

DW 

7 

; 'bx' 

cx_in 

DW 

7 

; 'ex' 

dx_in 

dcjxrgs 

m 

ENDS 

? 

; 'dx' 
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retjxrgs 

STRUC 

; Structure for returned parameters 

ax_out 

DW ? 

; Returned AX word 

bxjrnt 

Of ? 

; Ret tamed BX word 

cxjxut 

DW ? 

; Returned CX word 

dx_out 

DW ? 

; Returned DX Word 

retjxrgs 

ENDS 


DGROUP 

GROUP DATA 


DATA 

SEGMENT WORD PUBLIC 
ASSUME DS: GROUP 

'DATA' 


PUBLIC dc_ret 


dcjret 

retjxrgs <0,0,0,0> 

; Global variable ' dcjret ' declaration 


DATA ENDS 


PGHOUP 

PROG 


doseall 


dealt end 


doseall 


GROUP PROG 

SEGMENT WORD PUBLIC 'PROG' 
ASSUME CS:PGROUP , DS:DGR0UP 


PUSH 

MOV 


MOV 


PUBLIC doseall 
PROC NEAR 

BP 

BP,SP 

AX, [BP] .ax in 
BX,[BP].bx~ in 
CX, [BP], ex' in 
DX,[BP].dx~ in 
21H 

DGROUP: dcret . 
DGROUP: dejeet . 
DGROUP: dc_ret . 
DGROUP :dc_ret. 

AX, FALSE 
dcalljend 

ax, mm 

LABEL NEAR 
POP BP 
RET 
ENDP 


MOV 

INT 

MOV 

MOV 

MOV 


MOV 

JNC 


; Scale BP and set it up as a pointer into 
;the stack to retrieve passed arguments 
;Copy AX parameter from stack 
;Copy BX parameter from stack 
;Copy CX parameter from stack 
;Copy DX parameter from stack 
; Invoke MS-DOS System Function 
ax_out,AX ;AX word for return 

bxjyut,BX ;BX word for return 

ex_out,CX ;CX word for return 

dx_out ,DX ;DX Word for return 

; Assume no error* 


; Restore BP 


PROG 


ENDS 

END 


As an example of a C program performing an MS-DOS Function Call 
consider the following: 
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# define DUMMY 0 

struct dc_ret_tem { /* 'doscall ' return parameter structure * / 

char at; 
char ah; 
char hi; 
char bh; 
char cl; 
char ch; 
char dl; 
char dh; 

); 

extern struct dcjret^tem dcjpet; 

main () /* Prints the drive letter for the current default disc 

{ 

char drive; 

doscall ( 0x1900 , DUMMY, DUMMY, DUM4Y ); /* Current Disc System F’n 

if ( dcjpet. al < 12 ) 

drive ~ dcjret.al + 'A' ; 

else 

drive ~ ; 

printf ( " Current Disc is %c\r\n n , drive ); 


This program invokes MS-DOS System Function Call 19H (Current Disc) 
returns a number in AL indicating the current default disc drive, 
appropriate drive letter is printed. 
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MAKING AGIOS FUNCTION CALLS 


From the Microsoft C Language for example, AGIOS Function calls are most easily 
made through an assembly language routine combined with the C object at link 
time. AGIOS calls, being a special case of the doscall function previously 
described, could be performed using that assembly language routine. However for 
the sake of efficiency another routine is described. It is actually an assembly 
language coding of a Microsoft C compatible function. The function, when called 
with the appropriate parameters, can be used to invoke any AGIOS function. 
Parameters are passed on the stack. Note that since parameter passing 
conventions between routines vary from language to language, this function is 
particular to Microsoft C. Refer to Section 8, AGIOS Function Call Reference, 
for a directory of AGIOS functions. 


; int agios ( bufjxdd, length ) 

; int bufjidd, length 

9 

; Performs cm AGIOS function call with parameters passed using Microsoft 
; C language parameter passing conventions . Calls MSDOS function mother 044H 
; ( I/O Control For Devices) with sub-fimction 003H (Write to Device Control 

; Channel) using CON (console) handle. 

9 

; Parameters in: 

; bufjxdd - The address (offset - assumes same data segment) of the AGIOS 
; parameter buffer for the call. Specifies the particular 

; AGIOS function to be performed and other pertinent data for 

; the function. 

; length - Specifies the length of the above parameter buffer in bytes. 

9 

; Return value: 

; 0 - AGIOS function executed with no error. 

; Non-0 - AGIOS function executed with error. Value returned is the 

; status code returned from the function specified in the 

; parameter buffer (see AGIOS function documentation) . 

9 

; Parameters out: none 


PGBOUP 

GROUP 

PROG 



PROG 

SEGMENT BYTE PUBLIC 

1 'PROG ' 



ASSUME CS: PGBOUP 



CONIN 

EQU 

0 

; Standard MS-DOS console handle 

agios jxrgs 

STEUC 



; Stack structure for passed args 


m 

? 


;Callers BP 


W 

? 


; Return address 

huf_add 

m 

? 


; Parameter buffer address offset 

buflen 

w 

? 


;Nunher of bytes in parm buffer 

agiosjrrgs 

ENDS 
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PUBLIC 

agios 

agios 

FROC 

NEAR 


PUSH 

BP 


MOV 

BP,SP 


MOV 

AX, 0440 3H 


MOV 

BX,C0NIN 


MOV 

CX,[BP] ,buf len 


MOV 

DX,[BP] ,buf~ add 


INT 

21H 


POP 

RET 

BP 

agios 

ENDP 


PBOG 

ENDS 



;Write control string to AGIOS 
;Save callers BP 
initialize base pointer 
; MS-DOS System Function 44H, Sub- 
; Function 3 
; Device handle 

;Get length of parameter buffer 
;Get buffer address 
;Call MS-DOS 
; Restore callers BP 
; Return to caller 


END 


Since the above assembly language function can be used to perfrom any 
AGIOS function, you may wish to put a shell around it for any particular AGIOS 
functions called. This will be done for Function 17» Position Cursor in the 
following example. 

First, declare the parameter buffer structure and data area: 


struct agios jpcjbem 


{ 

unsigned int functjnm; 
char mode ; 

unsigned int column ; 
unsigned int roe; 

}; 


/* function number * / 
/* mode */ 

/* column number * / 
j* rots number */ 


The above serves as a template for the parameter buffer particular to the 
Position Cursor function. 


Now two constants, the parameter buffer length and the Position Cursor function 
number are defined: 


^define PC FLEN 
Sdefine PC~FNUM 


sizeof (struct agios jpcjtem) f* Function length */ 
17 /* Function number */ 


The following statement actually reserves a data storage area for the parameter 
buffer. 


struct agios jpcjbem agios jpcjpar » { PCJFNUM , 0 , 0,0, }; 

The Variable ' ret_code ' is used for the integer value returned by an AGIOS 
function call. The value indicates success or failure of the function call. 
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int ret_code; /* Function call return Value */ 

Vow the cursor positioning function is defined: 


cursor ( row , column. ) 

unsigned int row ; 
unsigned int colvmi; 

{ 

agios _pc_par„ row ~ row; 

agios jpcjpar.eoltam = column ; 

ret_code - agios ( &agios_pcjpar, FC_FLEN ); /* perform the AGIOS call */ 


Note that the mode parameter has not been defined. This would be done in most 
cases only once outside the above routine. The mode parameter is defined and 
the above function called with the following statements: 


agiosjpcjpar. mode * 0x99; 

cursor (2, 12); 


/* row and column parameters are both valid 
positive absolute window values */ 
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ALPHANUMERIC DISPLAY INTERFACING 


Alphanumeric Video RAM Structure 

The following information describes the internal architecture of the HP 150 
alphanumeric video structure. It provides programmers with a means of bypassing 
the console driver (CON: device) and its AGIOS function subset for the purpose 
of putting alphanumeric information to the screen. 

The AGIOS function set contains some powerful screen manipulation capabilities 
and is the preferred method of accessing the alpha (and graphics) video memory. 
In situations where these functions provide adequate functionality and 
performance they should be used. 

The HP 150 has 48 lines of display normally available to applications through 
console outputs and the AGIOS function calls. The following information applies 
only to the 27 lines (24 text plus two softkey plus one status) forming the 
physical screen as it appears at any given time. 

Each of the 27 lines of alphanumeric text displayed on the screen are 
represented by 80 consecutive words (pairs of bytes) in RAM. A table (video row 
pointer table) indexes the address of the first byte in each line. This table 
is read by the HP 150 video control hardware directly, and the video control 
chip DMAs into the appropriate area of memory accordingly. Note that 
consecutively displayed lines on the screen do not necessarily have thejlr 
storage areas ip a corresponding order in RAM. 


ALPHA VIDEO BUFFER FORMAT 


1 

160 

character 

buffer , 

line 

11 11 

a 

1 

1 

160 

character 

buffer , 

line 

it. 11 

b 

1 

1 

160 

character 

buffer, 

line 

11 11 

c 

1 

1 






1 

1 

JL __ _ 






1 

- — L 

l 

-L- . 

160 

character 

buffer, 

line 

11 H 

X 

— f 

1 

. _ „ J. 

T 

1 

_ . 

160 

character 

buffer. 

line 

II II 

y 

T 

1 


Note: the ordering 
of line buffers 
here in RAM is not 
indicative of their 
position on the 
screen 
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VIDEO ROW POINTER TABLE FORMAT 

The row pointer table also located in alphanumeric video RAM contains 27 
consecutive pointers indexing the first character of each line in the alpha line 
buffer. That is each pointer indexes the first byte in the above buffer. Note 
that the pointers are arranged line 1 through line 27 as described in the 
following diagram. 


Byte # 1 
2 

3 

4 

Byte # 5 

6 

7 

8 


Byte # 105 

106 

107 

108 


+ = = = = = = = = = = = = = = = = = = =: = = =+ 
| low byte of pointer | 

| not used | 

| high byte of pointer | 

| not used -- | 

+ = = :z = = = = = = = = = = = = = = = = = ==+ 


| low byte of pointer | 

| not used | 

| high byte of pointer | 

| not used | 

-h = = = =: = =:=: = = = = = = =: = = = = =: = =;=:+ 

I I 

4 bytes each for 
lines 3 “ 26 


+======================+ 

| low byte of pointer | 

| ----- not used | 


| high byte of pointer | 
| not used I 


+ 


+ 


forms row pointer 
for line 1 
(top of screen) 


forms row pointer 
for line 2 


forms row pointer 
for line 27 
(bottom of screen) 


ROW POINTER FORMULATION FROM ABOVE TABLE 

high byte of pointer low byte of pointer * 

| + + + 4 + + -5- — | + 4--~4 + 4 + + 

bit number |15 |l4 |13 |12 |11 |10 | 9 I 8 | 7 I 6 | 5 I 4 | 3 I 2 | 1 | 0 

| — 4. — + — + — + — 4 — — j — 4 — 4 — + — + — 4 — + — 4 — 

represents j *** | 14 bit word offset from alpha RAM origin (D0000H) 

j 4 4 4 4 4 — 4 4 | + 4 4 4- — 4 4 4 


The least significant bit (AO) must be a zero (0). 


*** These bits define the double height and width characteristics of the 
referenced row. Note that double high/double wide characters are not 
supported by the HP 150 firmware, software or hardware. 


D15 Dl4 

0 0 

0 1 

1 0 

1 1 


Single height, single width (standard) 
Single height, double width 
Double height top half, double width 
Double height bottom half, double width 


\ not 

| supported 
/ (will not work) 
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LINE BUFFER FORMAT 

The diagram below describes the format of each display line’s RAM buffer. 


first column position 
in line 

| + 1 

| character | attribute | 

| code | /char set | 

| + | 

| pair of bytes for | 

| each character pos- | 

| ition in line | 

+ — - -- -4. 


last column position 

in line 

Z I -+ 1 

| character | attribute | 

| code | /char set | 

Z 1 + | 


ENHANCEMENT/CHARACTER SET BYTE STRUCTURE 


D7 

- 4 . 

1 

D 6 

. 4 . 

1 

D5 

- + - 

1 

DU 

-4" 

1 

D3 

— f. 

| D2 

| D1 

-4 

| DO 

secur- 

1 

half 

1 

under- 

1 

inver- 

1 

blink 

1 

character 

set 

ity 

1 

. 4 . 

bright 

1 

* + * 

line 

1 

-4- 

se 

1 

-4- 


1 

-4 

code 

.4 


NORMAL ROMAN 0 

ROMAN EXTENSION 0 

LINE DRAWING 0 

MATH 0 

BOLD NORMAL ROMAN 1 


BOLD ROMAN EXTENSION 1 

ITALICISED NORMAL ROMAN . 1 
ITALICISED NORMAL ROMAN . 1 


0 

0 

1 

1 

0 

0 

1 

1 


0 

1 

0 

1 

0 

1 

0 

1 


CHARACTER CODE STRUCTURE 


D7 

-4 

| D6 

1 D5 

— 4 - 
! 

--- 4- 

DU | D3 

| D2 | D1 

| DO 

end of 
line * 

1 

1 

- 4 ~ 

- -4- 

T 

--4- 

— r — t — r 

7 bit character code ** 

4 4 - 4 



* The end of line bit, when set, will cause the remainder of the line to 
be blanked by the HP 150 video hardware. 

** The character sets may be seen by performing "SYSTEM TEST" from the 
HP 150 Service Keys softkey level. 
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Finding the Row Pointer Table Origin 

In order to find the base address of the row pointer table a call must be made 
to the firmware "memory manager" . The firmware manages the alphanumeric video 
memory and different versions of the firmware may place the pointer table in 
different places in RAM. For this reason it is necessary to call the memory 
manager at run time. 

The following assembly language routine will return a pointer which is an offset 
from the alpha RAM segment at 0D0000H. It is compatible with Microsoft C 
language function calling conventions. 

ALPHAJSEG Em 0D000H ; Alpha video RAM segment 

DGWUP GROUP DATA 

DATA SEGMENT WORD PUBLIC • DATA ' 

ASSUME DS:DGROUP 
DATA ENDS 


PGROUP GROUP PROG 

roti _ Jumps SEGMENT AT 0000H 

ORG 042FH 
memjngr LABEL FAR 

row _jumps ENDS 

PROG SEGMENT BYTE PUBLIC 'PROG' 

ASSUME CS: PGROUP, DS:DGR0UP,ES: NOTHING 


; unsigned int vid_tadd( ) 

9 

; /* Returns start address offset of video pointer table. Segment is 

; ' alpha jseg’ . video memory is addressed through a table of pointers 

; to absolute display locations. This function calls the firmware 

; memory manager and returns the table origin * / 

9 

9 
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PUBLIC vid tadd 

vidjtadd 

PROC 

NEAR 


PUSH 

BP 


PUSH 

DS 


PUSH 

ES 


MOV 

DX,7 


PUSH 

DX 


CALL 

mem mgr 


SUB 

BX, ALPHA SEG 


MOV 

CL ,4 


SHL 

BX,CL 


ADD 

BX, 12H 


MOV 

AX,BX 


POP 

ES 


POP 

DS 


POP 

BP 


RET 


vidjbadd 

ENDP 


PROG 

ENDS 



;Save BP 
;Save DS 
;Saoe BS 

;Call the firmare memory manager with 
; function 7: return segment of row 
; pointer table in BX. 

; Concert to ALPHAJ5EG relative address 
;Multiply by 16 

;Fixed offset to row table 

; Rest ore BS 
;Restore DS 
; Restore BP 


END 


Fetching Row Pointers from the Table 

Given the row pointer table origin, the following Microsoft C compatible 
assembly language function will return the pointer for any alphanumeric video 
row, zero through 26. Note that the pointer returned from this routine is a 
word pointer and that it must be multiplied by two to get the correct byte 
offset for the row origin. This is done in the qik_char function which follows. 
The function uses an external variable roW_tab which is assumed to contain the 
result of the vidjtad function above. The following C language statement would 
make that assignment: 

int rowjbab 

rowjtab - vid_tadd( ) ; 

Note that the variable rowjtab is declared external in the following assembly 
language code and defined in the C module above. 


EXTRN row_tab : WORD ;Base address of alpha video row pointer 

; table . Must be initialized from 
; ' vid_tadd ' funtion prior to use. 


; unsigned int roajptr ( row jam ) 

3 

; /* Returns start offset address of video row mother 'rowjnen' . 

; Segment is 'alphajseg' . Pointer comes from table whose base 

; is ' rowjtab ' is returned by function ' vid_tad/i ' . */ 
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rptr_args 

STfflC 


; Stack structure for passed arguments 


BW 

? 

;Callers BP 


W 

7 

; Return address 

rownum 

DW 

1 

; ' row _num' argument 

rptrjxrgs 

ENDS 




EVBLIC 

rowjptr 


rowjptr 

PROC 

NEAR 



PUSH 

BP 



war 

BP,SP 



MW 

BE, [BP] .row man 

; 'rowjmm' in BX 


SHL 

BX,1 

;4 bytes 


SHL 

BX,1 

;per entry 


MOV 

AX,DGROUP:roW tab 



ADD 

BX,AX 

;NoW have offset address of video row ptr 


PUSH 

DS 



MW 

DX, ALPHA SEG 



MOV 

DS,DX 



MOV 

AL,[BX] 

;Low order row pointer 


MOV 

AHJ3X+2] 

;High order row pointer 


POP 

DS 



POP 

BP 



RET 



rowjptr 

ENDP 




Placing a Character in Alpha Memory 

The Microsoft C compatible function qikjshar described below is an example of a 
routine which uses the row pointer returned by the above function to place a 
character onto the display in any row and column position. 


; qikjshar ( row, col , dispword ) 

9 

; /* Writes dispword (character code and attribute/ character set code into 

; alpha video memory at display row mmber 'row' and column number 'col' . 

; Uses row origin address returned by the 'rowjptr' function. 

9 

; Arguments in: 

; 'row' - screen position row number ( 0 < * row < 3 26) 

; 'col' - screen position column number (0 col < * 79) 

; ' dispjsord' - high order byte is attribute /character set byte 

; and low order byte is character code 

9 

; Return values: none 

9 

; Registers preserved: BP, SP, SI 
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qchar_args 

STRUC 


; Stack structure for passed argument 


W 

7 

; Callers BP 


m 

7 

• 

;Retum address 

row 

W 

? 

; Screen roti mother (0 < = roti <* 26) 

col 

DM 

7 

; Screen column mother ( 0 <■ col <= 79) 

dispword 

m 

? 

; attribute /char set and character bytes 

qcharjrrgs 

ENDS 



PUBLIC 

qik char 


qikjchar 

PROC 

NEAR 



PUSH 

BP 



MOV 

BP,SP 



MOV 

AX, [BP], row 

;Get video RAM address 


PUSH 

AX 

;Roto on stack for 'rowjptr' call 


CALL 

raw jrtr 


MOV 

DI , AX 

; Lines alpha RAM address word offset 


POP 

AX 

;row back off stack 


MOV 

AX, [BP], col 

;Coliatn off stack 


ADD 

DI , AX 

;Add to row displacement 


SHL 

DI,1 

;Two bytes per character 


MW 

AX, [ BP] . dispword 

;Char and enhancement codes from stack 


MW 

BX,DS 

;Saoe current data segment 


MOV 

CX, ALPHA SEC 

; Initialize alpha RAM segment 


MOV 

DS,CX 



MOV 

[DI] , AX 

;Put char and enhancement to alpha RAM 


MW 

DS,BX 

; Restore original data segment 


POP 

BP 



RET 



qikjehar 

ENDP 




NOTE 


It is necessary to initialize the video memory prior to using the above function 
for random character reads and writes. The firmware sets bit 7 of the character 
code to blank trailing portions of lines. Any character placed into the line 
buffer will not be displayed unless all proceeding character codes in the line 
have their most significant bits cleared (0). The following Microsoft C code 
uses the qikchar routine above to clear all those bits, writing a space with no 
attributes to display lines 1 through 24. 
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qik_in.it ( ) 

/* Initializes alpha RAM for random use of the ' qik_char ' function. Writes 
spaces to all character positions on lines zero through 23. This is 
required to remove any end- of -line markers in the memory. Should be 
called once prior to using the ' qik_char ' function in a random man ner * / 

{ 

int row; 
int col; 

for ( raw = 0; row <=» 23; ++rot») { 
for (col * 0; col <= 79; it col) ( 
qik char (row, col , 0x0020 ); 

); 

); 

} 


Writing to Lines 25, 26, and 27 

The HP 150 uses screen lines 25 and 26 for softkey labels, and line 27 as a 
status line. It periodically updates softkey labels and the cursor position 
counters on lines 25 and 26 , and the time and status messages on the 27th line 
from variables it maintains in other places in memory. The previously described 
character to screen routine qikjehax* is capable of writing to any screen line, 
including the last three. If that routine is to be used to place text on lines 
25 through 27 the firmware should be disabled from overwriting those lines with 
softkey and status text. The first of the two routines which follow will 
disable firmware modification of the last three lines of the screen. The second 
should be called prior to program termination to reenable that processing. 


FGROUP 

GROUP 

PROG 

firm jumps 

SEGMEWL’ 

AT OOOOH 


ORG 

0420H 

tkpjentry 

LABEL 

FAR ;Terminal handler process entry 


ORG 

043EH 

phpjzntry 

LABEL 

FAR ; Personality handler process 

firm jumps 

END S 


PROG 

SEGMENT 

BITE PUBLIC ' PROG ' 


ASSUME 

CS: FGROUP, DS:DGR0UP,ES: NOTHING 
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; stat_init( ) 

3 

; /* To use the status line on the HP150 , one must first disable the 

; portion of the firmware (the status line process ) that would 

; otherwise continually update the status line. After disabling the 

; status line process , a program can write into the video memory 

; representing the status line. 

3 

; Arguments: none 

3 

; Returned values: none 


3 

; Registers preserved: none */ 


stat init 


stab init 


PUBLIC 

stat init 

PROC 

HEAR 

MOV 

DX,1 

PUSH 

DX 

MOV 

DX,2 

PUSH 

DX 

CALL 

phpjentry 

MOV 

DS s DX 


MOV 

DXyO 

PUSH 

DX 

tm 

DXyO 

PUSH 

DX 

MOV 

DXyZ 

PUSH 

DX 

MOV 

DXyl 3 AH] 


PUSH 

DX 

MOV 

DX,6 

PUSH 

DX 

CALL 

thpjentry 

MOV 

DX,0 

PUSH 

DX 

CALL 

yield 

ENDP 



;Get DS register value for the 
; global context area for the 
; terminal personality 
;The DS register value is 
; returned in the DX register , 
; move it into the DS register 


;Code to disable status line process 

; Message type to send to status 
; line process 

; Using the DS value obtained above 
; get the token for the status 
; line process 


;Call TASK HANDLER PROCESS to 
; disable the status line process 


;The yield routine is described 
; elsewhere 
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; stat_clnu( ) 

9 

; /* This routine renables the fin Ware status line process causing it 

; to resume updating of softkey labels , cursor position information , 

; time , and status messages on the last three lines of the display. 

9 

; Arguments in: none 

9 

; Returned values: none 


9 

; Registers preserved: none * / 


9 


PUBLIC 

stat clnu 

stat clnu PROC 

HEAR 

MOV 

DX,1 

PUSH 

DX 

MOV 

DX,2 

PUSH 

DX 

CALL 

phpjzntry 

MOV 

DSyDX 


MOV 

DXyO 

PUSH 

DX 

MOV 

DX,1 

PUSH 

DX 

MOV 

DX,Z 

PUSH 

DX 

MOV 

DXJ3AHJ 



PUSH 

DX 


MOV 

DX,6 


PUSH 

DX 


CALL 

thpjentry 


MOV 

DX,0 


PUSH 

DX 


CALL 

yield 

statjslnu 

ENDP 


PROG 

ENDS 



END 



;Get DS register value for the 
; global context area for the 
; terminal personality 
;The DS register value is 
; returned in the DX register , 
; move it into the DS register 


;Code to enable status line process 

; Message type to send to status 
; line process 

;Vsing the DS value obtained above 
; get the token for the status 
; line process 


;Call TASK HANDLER PROCESS to 
; enable the status line process 


;The yield routine is described 
; elsewhere 
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GRAPHICS DISPLAY INTERFACING 


The display system on the HP 150 consists of two separate "planes", a character 
based alphanumeric plane and a bit mapped graphics plane 512 dots wide by 390 
dots high. The Alphanumeric and Graphics planes overlay each other on the 
display. 

A comprehensive set of high level functions are provided to access the graphics 
plane. The AGIOS function set (see System Software section) provides functions 
to perform vector draws, area fills, implement graphics -plane based character 
sets, etcetera. This is the preferred interface for programmers wishing to 
access the graphics bit-map. However there are situations where, for 
performance or ease of software transportation reasons, the programmer may wish 
to access the graphics bit-map directly. The following information describes 
how that may be done. 

Portion of the 8088 address space is allocated to a 32 kilobyte block of memory, 
the Graphics RAM (see Memory and I/O Mapping section). Of this 32 kilobyte 
block, a little over 2k kilobytes forms the graphics bit -map. The remainder is 
used by the firmware and should not be modified in any way by the programmer . 
The bit-map is organized as described in the following diagram: 

*y* ’x’ BIT POSITION 

BIT 

POSIT- : 0 :8 :l6 :2k :32 :40 

ION : 7: 15: 23: 31: 39: 

+ + + + +-- + - 

0 | C0000H | C0001H | C0002H | C0003H | COOOhH | 

+ + + + + + ~ ~ 

1 I COOl+OH | C0041H | C00U2H | C00b3H | C0044H | 

+ + + + + + ~ ~ 


+ + + +--- + + ~ ~ + + 

389 | C6140H 1 c6l4lH | C6142H 1 C 61 U 3 H | c 6 lMtH | I C 617 FH | 


A bit set ("1") will turn on the graphics dot corresponding to that bit 
position. 

An example of an assembly language procedure which accesses the graphics bit map 
follows. The routine is implemented as a Microsoft C Language compatible 
function which sets a bit (turns the graphics dot on) given the x and y 
coordinates . 


:504 : 

503: 511: 

— +' t 

| C003FH I 

| C007FH I 
+ + 
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3 

; bitjset ( x y y ) 

3 

; f* sets graphics bit map memory location for bit position 'x' on 
; scan line 'y' */ 


3 

3 

3 


int x,y; 


TOTS 

EQU 1 

; Boolean true for return value 

FALSE 

EQU 0 

;Boolean false for return Value 

dcjxrgs 

SFTVC 

; Stuck structure for passed parameters 


m ? 

■ Cal levs BP 


m ? 

’Return address 

ax_in 

m ? 

; 'ax' 

bx_in 

m ? 

;’bx’ 

cx_in 

m ? 

; 'ax' 

dx_in 

m ? 

;'dx' 

dcjxrgs 

ENDS 


retjxrgs 

serve 

;Structure for returned parameters 

axjnxt 

m ? 

; Returned AX itord 

bxjnxt 

m ? 

; Returned BX tford 

cxjmt 

m j 

; Returned CX tford 

dxout 

m ? 

; Returned DX tford 

retjxrgs 

ENDS 


DGROUP 

GROUP DATA 


DATA 

SEGMENT WORD PUBLIC 
ASSUME DS:DGROUP 

'DATA' 


PUBLIC dcjret 


dcjret 

retjxrgs <0 ,0,0 ,0> 

; Global voidable ' dcjret ' declaration 

DATA 

ENDS 
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FGBOUP GROUP PROG 

PROG SEGMENT BYTE PUBLIC 9 PROG 9 

ASSUME CS: PGROUP,DS: DGROUP 9 ES: NOTHING 


bs_arga 

STRUC 


; Stack structure for passed arguments 


m 

? 

; Callers BP 


m 

? 

; Return address 

X 

W 

? 

;x coordinate (0 < s x <* 511) 

y 

w 

7 

;y coordinate (0 <= y <«* 389) 

bsjxrga 

ENDS 




PUBLIC bit set 


bitjset 

PBDC 

NEAR 



PUSH 

BP 



MOV 

BP,SP 



MOV 

BX,[BP).y 

;Get y coordinate (0 <■ y <* 389) 


MOV 

AX,40H 

;40 bytes per line in bit map 


MUL 

BX 

;AX now contains start byte of graphics 
; raster line y. Ignore upper Word of 
; result as should be zero. 


MOV 

DI , AX 



MOV 

DXjBP].x 

;Get x coordinate (0 <= x <« 511) 


MOV 

AXyDX 

; Determine member of whole bytes across 


MOV 

CL, 3 

; x coordinate is. 


SR R 

AX, CL 



ADD 

DI , AX 

;Add to raster line byte offset. 


MOV 

CL,DL 



AND 

CL ,00000111B 

; Determine bit position from x 


MOV 

DL ,000000013 

; Create a mask 


EOL 

DL,CL 



MOV 

CXyOCOOOH 

; Graphics bit map segment 


MOV 

ESyCX 



OR 

ES:[DI],DL 

;Set the bit in graphics bit map 


POP 

BP 



RET 



bitjset 

ENDP 



dotajseg 

ENDP 



PROG 

ENDS 




END 




As an example of a C program using the above function, consider the following. 
This program takes 9111k Graphics Template stylus position inputs and scales the 
x and y coordinates down to the HP 150 graphics bit -map matrix size. The 
corresponding dot in the graphics bit -map is then turned on. In this way, the 
graphics template stylus acts as an “electronic pencil" for the HP 150 graphics 
display. Note that the stylus status check inhibits bit-map modification unless 
the stylus is depressed. 

The following main calling routine requires the following support code which is 
described elsewhere in this section: 
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- doscall function, see "MS-DOS System Function Calls from 

C Language" . 

- All routines (except main), structures , variables and cons taints 

from "HPIB Interface Example (911A Graphics Tablet)". 


/**************************************** ******************************* ****** j 

main( ) 

{ 

int x, y, status ; 

if ( tab init( ) ** 1 ) { /* initialize graphics tablet * / 

printf ( "%c*dA\n\r" , ESC ) ; /* clear graphics memory * / 

printf ( "%c*dC\n\r'' , ESC ); /* turn on graphics memory */ 

chile ( kbkit( ) ** 0 ) { 

get_x _y_status (Sac, &y, &status 3 tab handle) ; f* get data , * / 

/* if stylus tHthin bounds and 

is depressed, put dot on display */ 
if l (x <= 0x2de9) M (y <■ 0x2 16e) M 

( (status »■ 0x519) || (status =»= 0x719) ) ) { 
x ~ x/23; /* concert stylus position to */ 

y * 389 - (y/22); f* display bit map position * / 

hit set ( x, y ); /* turn on graphics memory bit * / 

); 

); 

); 

xenixclose (tab handle ); /* close the tablet */ 
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KEYBOARD INTERFACING 


The HP 150 keyboard includes many special function keys such as "Clear display". 
These keys are processed locally by the HP 150 firmware rather than being sent 
to an application requesting its information through the console input function 
and its associated high-level language inplementations (for example BASIC 
"INPUT" ). Applications may obtain additional control over the HP 150 keyboard 
by placing the HP 150 keyboard into what is termed "keycode mode". This mode 
allows such keys as Clear display to be passed to the application program rather 
than resulting in the display being cleared. 


Keycode Mode 

Through the use of keycode mode, applications cam detect activation of almost 
any HP 150 keyboard key as well as the state of the SHIFT, EXTEND CHAR, and CTRL 
keys in conjunction with other keys. Keycode mode also allows programs to 
receive touchscreen input and distinguish it from keyboard input. 

The following routines are examples showing how the HP 150 might be put into 
keycode mode. The AGIOS calls are more thoroughly described in the HP 150 
Programmer ’ s Reference Manual. The first function uses the AGIOS Keycode ON/OFF 
function to read and save the keycode mode (on or off). It could be used so 
that the following function ( kmjrest ) could restore the entry mode prior to 
program termination. The other two functions set keycode mode on and off 
respectively. Note that all functions are written in the C language and use the 
agios and datajaeg functions described elsewhere in this section. 


Mefine ON 1 
Fdefine OFF 0 


struct ogiosjcojtem 


Mefine KO_FLEN 
Mefine KOJNUM 


{ /* AGIOS Keycode Mode ON/OFF parameter temp* / 

unsigned ink ftmct man; 
char mode; 

}; 

sizsof( struct agios Jcojtem) 

43 /* Keycode mode ON/OFF function # */ 


struct agios _kstem 


Mefine KS FLEN 
Mefine KSJPNUM 


{ f* AGIOS Key Status parameter template */ 

unsigned int functjrum ; 
unsigned int buf offset; 
unsigned int bufjsegment ; 

); 

sizeof (struct agios JcsJbem) 

44 /* Read keycode mode status function # * / 


struct agios jcojtem agios Jcojpar a {KOJKHUM, 0 }; /* AGIOS set keycode 

mode command buffer * / 

struct agios JcsJbem agios Jcsjpar; /* AGIOS read keycode 

mode conmand buffer * / 

unsigned int entry Jam; 
int dseg; 


7-22 



Programming the HP 150 


ton jget( ) 

{ 

dseg a datajsegO; 

agios Jtsjpar. functjram » KSFNUM; /* Bead and sane keycode mode status */ 
agios _ksjpar.buf_off set * &entry_kcm; 
agios _ks_par. buf_segment * dseg; 
agios ( Aagios ksjpar, KS_FLEN) ; 

} 

fan rest( ) 

{ ~ 

agios _kojpar. mode ■ entry _kcm; /* Restore keycode mode state */ 

agios (6agios_ko_par f KOJFLEN); 

) 

km on( ) 

( “ 

agios Jkojpar. mode ■ ON; f* Turn on keycode reporting mode */ 

agios (&agios_ko jxzr, K0_FLEH); 

) 

km off () 

i 

agios Jwjpar. mode - OFF; /* Turn off keycode reporting mode * / 

agiosUkzgios kojpar , SO FLEN) ; 

) 


Console RAW/COOKED Mode 

It is advisable that MS-DOS be placed in RAW mode when doing keycode mode inputs 
from the keyboard, otherwise MS-DOS will process the key information looking for 
special control sequences such as Control-C (terminate program) and Control-P 
(toggle printer logging). The following routines show how the RAW/COOKED mode 
for the console may be manipulated. They are written in the C language and use 
the doscall function described earlier in this section. The first two functions 
are intended for initialization and cleanup respectively. They can be used to 
save the RAW/COOKED mode as at program entry, and restore it prior to 
termination. See the Programmer’s Reference Manual for more information on the 
MS-DOS I/O Control for Devices System Function Call. 


fflefine RJS/_MASK 0x20 /* MSDOS ioctrl - ran mode bit mask * / 

^define I0C_GET 0x4400 /* MS-DOS ioctrl - get device information */ 

# define IOCJSET 0x4401 /* MS-DOS ioctrl - set device information * / 

$ 'define STDIN 0 /* standard input MS-DOS file handle * j 

char entry _ioc; 
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ran jjet() 

{ 

do8ca.ll ( IOC_GET, STDIN ); 
entry _ioc * ( dcjeet . dl ) & OxOOPF; 

} 


/* Bead and scene ran/cooked mode * / 
/* MSB of entry _ioc must be zero 
before it is used to set mode V 


ran rest( ) 

{ 

doacalK I0CJ5BT , STDIN, 0, entry ioc ); /* Restore ran/ cooked mode state */ 

) 


ran on( ) 

{ 

doscalUlOC SET, STDIN , 0 , (entry ioc | RM MASK)); /* Set ran mode on */ 

) 


ran off() 

( 

doscalUlOC SET, STDIN, 0, (entry ioc & "Rffl MASK)); f* Turn off ran mode */ 

) 


Key Characteristics 

While in keycode mode, the characteristics of each key may he set individually. 
Specifically each key may be: 

- Processed normally (for example Clear display clears the display) 

- Intercepted and passed to the application for processing 

- Ignored 

- Any of the above accompanied by a bell beep 

The following C language functions turn the interception mode on and off for all 
keys on the keyboard. The programmer could modify these routines to selectively 
define individual keys with any of the above characteristics. Note that it is 
not possible to read and save the key characteristics prior to changing them so 
that they could be restored prior to program termination. See the HP 150 
Programmer’s Reference Manual for more information on the AGIOS Define Key 
Characteristics function. 


struct agios_dk_tem ( /* AGIOS Define Key Characteristics */ 

unsigned int functjnm; 
unsigned int characteristics; 
unsigned int keycode ; 

); 

^define DKJELEN sizeof ( struct agios _dk_tem) 

Edefine DK FNUM 40 /* Define Key characteristics function # * / 

struct agios _dkjcem agios _dk_par ~ {DKJPNUM, OaOOOZ, OxOOFE); /* AGIOS 

define key characteristics command buffer */ 
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int on( ) 

i 

agios _dk _par. characteristics * 0x0002; /* Turn on key intercept mode * / 

agios ( &agios dk_par , DK FLEN) ; /* for all keys * / 

} 

int off() 

{ 

agios _dk_par. characteristics * OxOOOO ; /* Turn off key intercept mode */ 
agios ( &agios_dk jpar, DKJFLBN); 

) 


Sample Keyboard Driver 

The following program and its support function ’key_hit’ demonstrate how one 
might use keycode mode. The main calling routine initializes the HP 150 by 
saving the state of RAW/COOKED and keycode modes prior to setting them on. It 
then loops printing keyboard statistics for keys pressed and terminates 
following depression of the "Stop" key. Prior to termination, RAW/COOKED and 
keycode modes are restored as at entry. 


^define KBDJxFAlFUS 0x4406 /* MS-DOS ioctrl - get input status * / 

# define RBAD_FC OxSFOO /* MS-DOS read file/deoice function matter * / 

# define TMJE 1 

tide fine FALSE 0 

struct key_buf_tem { f* keycode buffer template * / 

char flags; 
char id; 
char lieyccde; 
char unused; 

); 

struct key_buf_tem keybuf; /* Holds a single entry read from 

the keyboard buffer while in keycode mode */ 
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main( ) 

{ 

raw _get( ) ; /* remember current console RAW /COOKED mode */ 

km_get( ) ; /* remember current keycode mode */ 


rcoi_on( ) ; 
intjonf ); 
km_on( ) ; 


/* turn on console RJSf mode */ 

f* turn on hey intercept mode for all keys */ 

/* turn on keycode mode * / 


do { 

if ( key hit() ) ( 

printf ( " Data from keyboard: FLAGS * %a; ID • %x; KEYCODE • %z\r\n" 
, key buf .flags, keyjmf.id , key _buf .keycode ); 

); 

} while ( key Jouf. keycode /* 0x58 ); 
km_rest( ); /* restore keycode mode as at entry */ 

int_off( ); /* turn intercept mode off again */ 

raw_re$t(); /* restore raw mode as at entry */ 


keyjtiti ) 

/* Checks for data in the HP- 150 keyboard type ahead buffer. This routine 
checks to see if there are any keys in the keyboard type ahead buffer. 
If so the data for the first key is read from the buffer and placed in 
a structure variable. 

Arguments in: Hone. 

Return value: 

TRUE if a key Was read from the buffer 
FALSE if nothing Was read from the buffer * / 

{ 

doscal l (KBD_STATUS, 
if ( dcjpet.al ) { 
doscal l ( READFC , 
return ( THIS) ; 

} 

return ( FALSE) ; 


Flushing the Keyboard Buffer 

The following routine flushes the keyboard type -ahead buffer by reading all the 
keys from it until none are left. Note that the keyboard type ahead buffer is a 
firmware buffer, not an MS-DOS buffer. The only way to flush the firmware 
buffer is to read keys from the MS-DOS device until the buffer is empty. After 
reading a key from the MS-DOS device the MS-DOS task must yield to the firmware 
to allow it to remove another key from its buffer and pass it to the MS-DOS 
task. An assembly language routine which will yield control to the firmware 
follows the flush _kbuf routine. 


STDIN , 0, 0 ); 


STDIN, 4 , &key_buf); / 

/* 


/* If there are any keys in the * / 
/* keyboard type ahead buffer */ 
then read the data bytes * / 

for the first key V 
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flush _kbuf( ) 


/* Flush HP- ISO keyboard type ahead buffer * / 


{ 

struct key_buf_tem trashjxm ; 


/* temporary buffer to deposit keys */ 


) 


dosca.ll ( KBDJST/miS , STDIN, 0 , 
while ( dcjcet.dl ) { 

doscall ( READJC, ST DIN, 4, 
yield ( 1 ); 

doscall ( KBDJSTATUS , STDIN, 

} 


0 ); /* Read everthing in the type */ 

/* ahead buffer and ignore it */ 
itrashjsan ); 

/* Yield to allow the firmware to* / 
0 , 0 ) ; / * Put any pending keys in the * / 

/* MSDOS key buffer */ 


YIELDJCN 

mu 

009H 

; Task handler yield function code 

DGROUP 

GROUP 

DATA 


DATA 

SEGMENT WORD PUBLIC 
ASSUME DS-.DGROUP 

’DATA’ 

TUP ENTRY 

LABEL 

DWORD 

;Task handler entry point 

THP~ OSET 

W 

00420H 

;0ffset 

THPJ5EG 

m 

OOOOOH 

; Segment 

DATA 

ENDS 



PGBOUP 

GROUP 

PROG 


PROG 

SEGMENT BYTE PUBLIC 

'PROG 1 


ASSUME CS : PGBOUP, DS:BGRDUP, ES: NOTHING 


9 

; yield ( tints ) f* Yield control to firmware * / 

; int time; (* Time parameter to firmware * / 

9 

; Calls the firmware task handler with a function code indicating that 
; any pending firware tasks should be allotted to process for a specified 
; period of time. 


Arguments in: 

time - minimum number of milliseconds that the firmware will have 

control up to a maxitmm value determined by the firmware. A 
Value of zero twill simply cause the MSDOS task to be placed 
on the end of the firmware ready task list. 

Return value: None. 


Registers preserved: BP, ES 
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YIELDJBGS 

snvc 



W 

? 


DM 

? 


W 

? 

YIELD TIME 

W 

? 

YIELDJBGS 

ENDS 



PUBLIC YIELD 

YIELD 

PROC 

NEAR 


PUSH 

ES 


PUSH 

BP 


MOV 

AX, [BP]. YIELD TIME 


PUSH 

AX 


MOV 

AX, YIELD FCN 


PUSH 

AX 


CALL 

DGROUP:THP ENTRY 


POP 

BP 


POP 

RET 

ES 

YIELD 

ENDP 



; Stack structure for passed args. 
;Caller's BP 
;Caller's ES 
; Return address 

; Minimum milliseconds for yield 


; Yield to fimare tasks 
;SaOe callers BS 
;SaVe callers BP 
;Yield time parameter 

; Yield function code 

;Cdll firmware task handler 
; Restore callers BP 
; Restore callers BS 
; Return to caller 


PROG ENDS 

END 
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Keycode Tables 


+ + 

| US ASCII KEYCODES | 


1 Key 
1 # 

- + + - 

| Physical | 

| Key addr | 

+ . 

Normal | 

1 

+ . 

Control | 

1 

Shift 

-+ 

| Extended 
| 8-bit yes 

Character 
| 8-bit no 

-+ 

| Special 
1 flag 

001 

— — — ■ — + ■ 

057 

054 

054 

FFF 

054 

054 

1 

002 

03A 

058 

FFF 

05A 

058 

058 

1 

003 

03D 

000 

000 

000 

000 

000 

1 

004 

03E 

001 

001 

001 

001 

001 

1 

005 

03F 

002 

002 

002 

002 

002 

1 

006 

038 

003 

003 

003 

003 

003 

1 

007 

008 

053 

FFF 

059 

053 

053 

1 

008 

OOF 

051 

FFF 

FFF 

051 

051 

1 

009 

00E 

oo4 

004 

004 

004 

004 

1 

010 

00D 

005 

005 

005 

005 

005 

1 

Oil 

OOC 

006 

006 

006 

006 

006 

1 

012 

00B 

007 

007 

007 

007 

007 

1 

013 

00A 

043 

043 

049 

043 

043 

1 

014 

009 

042 

069 

048 

042 

042 

1 

015 

03C 

060 

000 

07E 

OFB 

060 

0 

016 

02C 

031 

FFF 

021 

0B8 

031 

0 

017 

051 

032 

FFF 

040 

040 

032 

0 

018 

044 

033 

FFF 

023 

023 

033 

0 

019 

045 

034 

FFF 

024 

0F7 

034 

0 

020 

046 

035 

FFF 

025 

0F8 

035 

0 

021 

047 

036 

FFF 

05E 

05E 

036 

0 

022 

o4o 

037 

FFF 

026 

05C 

037 

0 

023 

010 

038 

FFF 

02A 

05B 

038 

0 

024 

017 

039 

FFF 

Q28 

05D 

039 

0 

025 

0l6 

030 

FFF 

029 

0B9 

030 

0 

026 

015 

02D 

02D 

05F 

0F6 

02D 

0 

027 

014 

03D 

03D 

02B 

OFE 

03D 

0 

028 

013 

027 

027 

027 

027 

027 

1 

029 

012 

044 

o44 

044 

044 

044 

1 

030 

Oil 

045 

045 

045 

045 

045 

1 

031 

o49 

024 

024 

026 

024 

024 

1 

032 

o4a 

071 

Oil 

051 

FFF 

071 

0 

033 

o4b 

077 

017 

057 

07E 

077 

0 

034 

o4c 

065 

005 

045 

0D7 

065 

0 

035 

o4d 

072 

012 

052 

FFF 

072 

0 

036 

04E 

074 

01 4 

054 

FFF 

074 

0 

037 

04F 

079 

019 

059 

FFF 

079 

0 

038 

048 

075 

015 

055 

FFF 

075 

0 

039 

018 

069 

009 

049 

FFF 

069 

0 

040 

OIF 

06F 

OOF 

o4f 

0D6 

06F 

0 
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+ + 


| US ASCI I KEYCODES | 


1 Key 
1 # 

-+ + • 

| Physical | 

| Key addr | 

Normal 

. + + - 

| Control | 

1 1 

+- 

Shift | 

1 

Extended 
8-bit yes 

Character 
| 8 -bit no 

-+ 

| Special 
1 flag 

04l 

01E 

070 

010 

050 

0F1 

070 

0 

042 

01D 

05B 

01B 

07B 

0B3 

05B 

0 

043 

01C 

05D 

01D 

07D 

07C 

05D 

0 

044 

01B 

05c 

QIC 

07C 

FFF 

05C 

0 

045 

01A 

o 4 o 

06B 

046 

040 

040 

1 

046 

019 

o 4 i 

06D 

047 

04l 

G4l 

1 

047 

043 

056 

056 

056 

056 

056 

1 

048 

03B 

FFF 

FFF 

FFF 

FFF 

FFF 

0 

049 

053 

061 

001 

04l 

0D4 

061 

0 

050 

054 

073 

013 

053 

ODE 

073 

0 

051 

055 

064 

004 

044 

0E4 

064 

0 

052 

056 

066 

006 

046 

OBE 

O66 

0 

053 

039 

067 

007 

047 

OBA 

067 

0 

054 

050 

068 

008 

048 

OBC 

068 

0 

055 

020 

o 6 a 

00A 

04a 

024 

o 6 a 

0 

056 

027 

o 6 b 

00 B 

04B 

OBF 

o 6 b 

0 

057 

026 

06c 

00c 

04 c 

OBB 

06c 

0 

058 

025 

03B 

03B 

03A 

OAF 

03B 

0 

059 

024 

027 

027 

022 

060 

027 

0 

060 

023 

025 

025 

025 

025 

025 

1 

061 

022 

02C 

06E 

02D 

02C 

02c 

1 

062 

021 

02F 

02F 

02F 

02F 

02F 

1 

063 

071 

055 

055 

057 

055 

055 

1 

064 

04l 

FFF 

FFF 

FFF 

FFF 

FFF 

0 

065 

073 

07A 

01A 

05A 

FFF 

07A 

0 

066 

074 

078 

018 

058 

OEC 

078 

0 

067 

075 

063 

003 

043 

0B5 

063 

0 

068 

076 

076 

016 

056 

OBD 

076 

0 

069 

077 

062 

002 

042 

OFC 

062 

0 

070 

070 

06E 

00E 

04E 

0F9 

06E 

0 

071 

028 

06D 

00D 

04D 

OFA 

06D 

0 

072 

02F 

02C 

02C 

03C 

03C 

02c 

0 

073 

02E 

02E 

02E 

03E 

03E 

02E 

0 

074 

02D 

02F 

02F 

03F 

05F 

02F 

0 

075 

042 

FFF 

FFF 

FFF 

FFF 

FFF 

0 

076 

02B 

052 

052 

052 

052 

052 

1 

077 

02A 

020 

065 

029 

020 

020 

1 

078 

029 

02E 

06C 

02E 

02E 

02E 

1 

079 

072 

050 

05C 

05B 

050 

050 

1 

080 

036 

FFF 

FFF 

FFF 

FFF 

FFF 

0 
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+ + 

I USASCII KEYCODES I 


Key 

# 

"T T * 

| Physical | 

| Key addr | 

Normal | 
1 

T . 

Control | 

1 

Shift 

— T 

| Extended 
| 8-bit yes 

Character 
| 8-bit no 

-f 

| Special 
1 flag 

08l 

037 

020 

020 

020 

020 

020 

“T — — — — — — — — * 
0 

082 

035 

FFF 

FFF 

FFF 

FFF 

FFF 

0 

083 

033 

023 

06l 

02A 

023 

023 

1 

084 

032 

021 

062 

028 

021 

021 

1 

085 

031 

022 

063 

02B 

022 

022 

1 

086 

06F 

008 

008 

008 

008 

008 

1 

087 

06D 

009 

009 

009 

009 

009 

1 

088 

06b 

00A 

00A 

00A 

00A 

00A 

1 

089 

069 

00B 

00B 

00B 

00B 

00B 

1 

090 

067 

071 

071 

071 

071 

071 

1 

091 

065 

073 

073 

073 

073 

073 

1 

092 

063 

072 

072 

072 

072 

072 

1 

093 

061 

070 

o6a 

070 

070 

070 

1 

094 

G5F 

037 

037 

037 

037 

037 

1 

095 

05D 

038 

038 

038 

038 

038 

1 

096 

05B 

039 

039 

039 

039 

039 

1 

097 

059 

075 

075 

075 

075 

075 

1 

098 

05E 

034 

034 

034 

034 

034 

1 

099 

05C 

035 

035 

035 

035 

035 

1 

100 

05A 

036 

036 

036 

036 

036 

1 

101 

058 

074 

074 

074 

074 

074 

1 

102 

066 

031 

031 

031 

031 

031 

1 

103 

064 

032 

032 

032 

032 

032 

1 

104 

062 

033 

033 

033 

033 

033 

1 

105 

06E 

030 

030 

030 

030 

030 

1 

106 

o6a 

077 

077 

077 

077 

077 

1 

107 

060 

076 

076 

076 

076 

076 

1 


NOTE 


1. The keyboard key numbers are specified in decimal, all other entries are 
specified in hexadecimal. 

2. A keycode entry of ’FFF’ means that no keycode is returned for that key 
sequence . 


7-31 




Programming the HP 150 


3. The key codes were obtained using Rev. B of the firmware ROM’s: 

1818-3321, 1818-3322, 1818-3323, 1818-332U, 1818-3325 
Keycode reporting differences in Rev. A of the firmware ROM’s: 

CTRL <key 072 > does not report a keycode 
CTRL <key 073 > does not report a keycode 
CTRL <key 097 > reports keycode 05C 

4. The keycodes were recorded with the keyboard state set as follows: 

Keycode mode on. 

Console device in raw mode. 

Intercept mode set for all keys. 

Control-C checking off. 

Caps mode off (keyboard key function) . 

Caps lock off (configuration menu function). 

Language USASCII (configuration menu function). 

Application softkey labels displayed. 


5. Every keycode returned to an application is made up of four bytes: 


\ .=========================1 

\ ! Qualifier flag byte ! keycode+0 

\ . ========================= 1 

Defined by \ 1 Keycode source ID l keycode+1 

HP-150 firmware > ! ========================= l 

/ { Keycode l keycode+2 

/ j ========================= | 

/ f Undefined ! keycode+3 

/ j ========================= 1 


Qualifier byte format: 


1 ======================================= j 

! SP ! XX ! LE ! RE ! CT ! LS ! RS ! RP ! 
!=======================================! 

SP - Special key 
XX - Reserved 

LE - Left extended character key down. 
RE - Right extended character key down 
CT - Control key down 
LS - Left shift key down 
RS - Right shift key down 
RP - Repeating key 


Keycode source ID byte: 

0C0H - Keyboard data 
08 OH - Touchscreen data 


6. Keycodes vary with the keyboard ( language) field of the terminal 
configuration menu. 

7. CTRL -numeric keys on main keyboard section (not numeric) report keycodes 
in an erratic manner. These key sequences should not be used for this 
reason. 
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Keyboard Key Position Numbers 
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PROGRAMMING DATA COMMUNICATIONS 


The HP 150 personal computer has comprehensive data communications facilities 
which are accessible to the programmer. There are two data communications 
ports, both of which are capable of running in synchronous or asynchronous mode. 
Only asynchronous mode is supported by the system firmware and software. If you 
wish to program the HP 150 to use synchronous mode it will be necarrary to write 
your own hardware level I/O, configuration, and interrupt drivers. For persons 
wishing to do such things, see the "Data Comm at the Hardware I/O Level" 
discussion later in this section. 

The following information should make your task of interfacing to the HP 150’s 
powerful data communications capabilities relatively simple, especially for 
asynchronous operation. The discussion covers logical (COM1 and COM2) to 
physical (Portl and Port 2) configuration, input and output of data through these 
devices, programmatic reconfiguration of the port asynchronous operating 
parameters, and port hardware interfacing. Included is an example of a simple 
terminal emulator application program. 


Data Comm Using COM1 and COfc32 Logical Devices 

Input/Output to the C0M1 and COM2 devices can be performed using the MS-DOS 
"Read from a File/Device" and "Write to a File/Device" System Function Calls. 
The device in question must be "opened" prior to accessing it in this maimer, 
smd should be "closed" when access is complete, usually just prior to 
application program termination. It may be necessary to have the user assign 
C0M1 and/or COM2 to one of the physical serial I/O ports on the HP 150 prior to 
running your application. 


NOTE 


Serial communications I/O through the MS-DOS COM devices is somewhat slow 
because of operating system and firmware overhead. In practice throughput rates 
of around 2h00 baud (half duplex) can be attained. For higher throughput it may 
be necessary to use the MS-DOS I/O Control for Devices System Function Call or 
deal directly with the hardware. See "Data Comm Control Functions" later in 
this section. 


ASSIGNING COM1 AND COM2 TO PHYSICAL PORTS 

C0M1 and COM2 are recognized as device names by MS-DOS. They may be mapped 
(assigned) to either of the physical hardware ports, "Portl" and "Port2". There 
is aui RS232 connector for Portl and am RS232/U22 connector for Port 2 at the rear 
of the HP 150. Both these ports are standard on the HP 150. The mapping 
between C0M1/C0M2 and Portl/Port2 is stored in non-volatile memory on the HP 
150. Currently the only trivial way to change this assignment is to run the 
"DEVCONFG" utility prograun shipped with the HP 150 operating system. The 
default mapping has C0M1 assigned to Portl and COM2 assigned to Port2. This 
means that MS-DOS references to C0M1 cause Portl hardware to be accessed, and 
references to COM2 cause Port2 hardware to be accessed. The assignment of Portl 
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and Port2 as the "Remote/Serial" devices in the DEVCONFG utility has no meaning 
here and will not alter the logical to physical device mapping. 


OPENING THE COM DEVICES 

The MS-DOS "Open a File" System Function Call (3DH) provides a "handle" or 
device identifier used for input and output of data and control information to 
the device. The function call is made passing a pointer to a character string 
being the device name, C0M1 or COM2 in this case. The character string must be 
terminated by a null byte. The following is a C language example of a call to 
open the C0M1 device. It uses the doscall function previously described. 


tide fine OPKHJW 0x3D02 /* MS-DOS Open File/Device System Function */ 

# define IKJMtB 0 /* dummy 'doscall' argument * / 

struct dc_ret_tem { /* 'doscall' return parameter structure * / 

char at; 
char ah; 
char hi; 
char bh; 
char cl; 
char ch; 
char dl; 
char dh; 

); 

extern struct dcjcetjtem dc_ret ; 

char comljiamel 5] * { "COM1" } ; 

char ccmhandle; 

{ 

coml_name[4] ■ 0; /* terminate device name string with NULL */ 

doscall ( OPEMJW, DUMMY, DUMMY, &ccml_name[0] ); /* open C0M1: device */ 

ccmhandle = dc ret. at; 

) 


The above code associates the variable comhcmdle with a handle used for all 
future references to the C0M1 device while it remains open. 


INPUT FROM THE COM DEVICES 

As mentioned, data input from the serial communications devices is most easily 
performed using the MS-DOS "Read from a File/Device" System Function Call (3FH). 
This function allows single or multiple character input from the device. The 
Read from a File/Device function will wait on a character if none exists when 
called. The firmware level drivers for Portl and Port2 buffer incoming and 
outgoing data. If the port incoming buffer is empty when the read function is 
called, the function will not return with a character until a byte is received 
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at the serial interface for the port. Otherwise the function will return a 
character from the buffer and adjust the buffer accordingly. 

The MS-DOS I/O Control for Devices System Function Call can be used to check the 
Portl and Port2 incoming buffer status. The function is called using the "get 
input status" request as in the following C language example. 


((define IOC_INSTAT 0x4406 /* MS-DOS I0CTL Function - get input status */ 

{ 

doscall (IOC INSFAT, comhandle ) ; /* check device input stat */ 

if ( dcjcet.al ■■ OxFF ) 

/* buffer contains data */; 

else 

/* buffer is empty */; 


The above I/O Control for Devices function with the get input status request 
would normally be called prior to reading a character from the device. Note 
that this may not be a valid function call for devices other than C0M1 and COM2. 
The following is a C language example of a single character input from a open 
device with the handle comhandle . It uses the doscall function previously 
described. The input character is placed in variable inchar. 


Sdefine BEAD Ox3FOO /* MS-DOS Read From File/Device System Function */ 
char inchar; 

{ 

doscall ( READ, comhandle , I, &inchar ); f* char in from device * / 

) 


OUTPUT TO THE COM DEVICES 

The MS-DOS "Write to a File/Device" System Function Call allows single or 
multiple character output to the serial communication devices among others. 
Once again, it is advisable to check status prior to making the call in case the 
device outgoing buffer is full. The following example shows how this may be 
done in the C language. 


((define IOCJ3UTSTAT 0x4407 /* MS-DOS IOCTL Function - get output stat */ 

{ 

doscall ( IOCJJUTSTAT , comhandle ); /* check device output stat */ 

if ( dc_ret.al == OxFF ) 

f* buffer can accept data */; 

else 

/* buffer is full * /; 
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Given that ready is returned by the check output status call above, the MS-DOS 
"Write to a File/Device" System Function Call is used in the following example 
to send the character variable outchar. 


^define WRITE 0x4000 /* MS-DOS Write To File /Device System Function * f 

char out char; 

{ 

doscall ( WRITE, conhcmdle, 1, &outehar ); /* write char, to device */ 

) 


CLOSING THE COM DEVICES 

An application which has opened devices or files should close them prior 
to termination. If either of the MS-DOS COM devices are opened, as C0M1 
is above, they should be closed using the MS-DOS "Close a File Handle" System 
Function Call (3EH). The following example shows how that device may be 
closed in C language, conhandle and comljmme variables are as 
defined in the device open example as previously described. 


{ 

doscall l CLOSE 3 eomhandle ); f* close the COM1: device *f 

) 


COM DEVICE I/O EXAMPLE - A TERMINAL EMULATOR 

The following example implements a simple terminal emulator for the HP 150. It 
will use the C0M1 device and sends all escape and control sequences as well as 
special keyboard keys to the firmware for processing in a manner consistent with 
"terminal" mode on the HP 150. Pressing ! on the keyboard terminates the 
application. To use this application on a HP3000 computer, the Port to which 
C0M1 is assigned should be configured as for HP3000 Point-to-Point (system 
defaults) . 
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fdefine THJE 1 

tdefine FALSE 0 

Fdefine RJVJ4ASK 0x20 /* MSDOS ioctrl - raw mode bit mask * / 

tdefine OPENJV 0x2002 /* MS-DOS Open File /Device System Function * / 

tdefine CLOSE OxZEOO f* MS-DOS Close File/Device System Function */ 

Fdefine MAD OxZFOO /* MS-DOS Read From File/Device System Function */ 

# define WRITE 0x4000 /* MS-DOS Write To File /Device System Function */ 

tdefine IOCJSET 0x4400 /* MS-DOS IOCTL Function - get device information */ 

# define IOC SET 0x4401 /* MS-DOS IOCTL Function - set device information */ 

Fdefine IOC~ INSTAT 0x4406 /* MS-DOS IOCTL Function - get input status */ 

tide fine IOCJXJTSTAT 0x4407 /* MS-DOS IOCTL Function - get input status */ 

Sdefine STDOUT 1 /* standard output MS-DOS file handle (console) * / 

# define DUMMY 0 /* dummy ' doscalV argument */ 

struct dc_ret_tem ( /* ' doscall ’ return parameter structure */ 

char al ; 
char ah; 
char bl; 
char bh ; 
char cl; 
char ch; 
char dl; 
char dh; 

}; 

char dcentioc; 
char carftandle; 
char out char; 
char inchar; 
char terminate; 

char coml_name[ 5] * { "COM!" ); 
extern struct dc_ret_tem dc_ret; 

main( ) 

{ 

coml_name[ 4 ] « 0; /* terminate device name string with NULL */ 

doscall ( OPENJSi, DUMMY , DUMMY, &coml_name[ 0] ); /* open COM1: device */ 

comhandle ~ dcjcet.al; 

doscall ( IOCJSET , comhandle ); /* Read and save console raw/ cooked male */ 
dcent_ioc ~ ( dc_ret.dl ); 

doscall ( IOCJSET y conhandle,0 y (dcent_ioc | RAWJtASK)); /* Set raw mode on */ 
terminate a FALSE; 
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do { 

if ( kbhitO /« OxOO ) { 

outchar * getchf ); f* get character from kbd */ 

if ( outchar **'!’) /* end program often ! pressed */ 

terminate 3 TRUE; 

doscall ( WRITE, comhandle , 1, &outchar ) ; /* Write char, to COM2: */ 

)i 

doscall ( I0CJ5TAF , comhandle ) ; /* check COM1: input status * / 

if ( dcjpet.al ** OxFF ) { 

doscall ( READ, comhandle, 1, Ainchar ); /* char in from COM1: */ 

do l /* wait for COM1 output ready */ 

doscall ( IOCOUTSTAT, comhandle ); 

} while ( dcjpet.al !- OxFF ); 

doscall ( WRITE , STDOUT , 2, ftinchar ) ; /* character out to console */ 

); 

) while ( ! terminate ); 

doscall ( IOC _SET , comhandle ,0 ,dcent_ioc) ; /* Restore raw/ cooked mode state * / 
doscall ( CLOSE, ccmhandle ); /* close the COM1 : device */ 

) 


Programmatic Configuration of Data Comm 

The current configuration of each data communications port may be determined by 
making a call to the HP 150 data communi cat ions driver firmware. The calls are 
made by referencing a particular physical port - that is, Portl or Port 2. Note 
that either of these ports are configurable as MS-DOS devices C0M1 or COM2. 
Currently there is no trivial way of determining the mapping in a programmatic 
manner. This information is stored in non-volatile CMOS memory and is managed 
by the DEVCONFG utility. The location of the mapping data which the DEVCONFG 
utility manages is dynamic, that is it varies from version to version of the 
utility. Unlike the firmware which may be called to return configuration 
information which it manages, the DEVCONFG utility has no such facility. 
Accessing the CMOS memory directly to manipulate or read the Portl/Port2 to 
C0M1/C0M2 mapping data will introduce DEVCONFG version dependencies. This 
should be avoided at all costs. Stated in simple terms, if your application 
must reconfigure either of the serial ports vising the methodology to be 
described, your application will require the user to have fixed Portl/Port2 to 
C0M1/C0M2 mapping. 


READING THE CURRENT CONFIGURATION 

The firmware call to be described will read configuration menu items into a data 
structure defined by the caller. The structure has a fixed format and is 7 
bytes long. Three additional header bytes and one additional trailer word are 
defined as part of the structure. These bytes are used for firmware use during 
the read configuration described here and the verify and reconfigure datacomm 
functions to be described later. 

The configuration data structure elements (ignoring the bytes used by the 
firmware) are defined as follows: 
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misc_l: bit bit bit bit bit bit bit bit 

7651*3210 

+ + + + + + + + + 

| 1 Stop| CS(CB) | SRR | RR(CF) | SRR | SR(CH) | Chk | ENQ | 

I Bit I Xmit I Invert! Recv j Xrait ! j Parity! ACK j 

+ + + + + + + + + 



0 2Stop 

0 No 0 No 0 No 0 No 0 Lo 

0 No 0 No 


1 IStop 

1 Yes 1 Yes 1 Yes 1 Yes 1 Hi 

1 Yes 1 Yes 

misc_2: 

bit 

bit bit bit bit bit 

bit bit 


7 

A JL - 

6 5 4 3 2 

1 0 


| TR(CD) | 

DM(CC)i i i | 

| 7 Data| Xmit | 


1 1 

Xrait | I I I 

j Bits j Pace j 


i — + • 

0 Lo 

0 No 

— + * ¥■ 

0 SData 0 None 


1 Hi 

1 Yes 

1 TData 1 Xon/Xoff 

baud_rate : 

02H 

110 Baud 



0l*H 

150 Baud 



05H 

300 Baud 



06H 

600 Baud 



07H 

1200 Baud 



OAH 

2400 Baud 



OCH 

4800 Baud 



OEH 

9600 Baud 



OFH 

19200 Baud 


parity: 

0 

Zeros 



1 

Ones 



2 

Even 



3 

Odd 



l* 

None 


clock: 

0 

I NT CLOCK 



1 

EXT XI CLOCK 



2 

EXT Xl6 CLOCK 


asterisk: 

0 

No Asterisk 



1 

DM Asterisk 



2 

RR Asterisk 



3 

Line Asterisk 



4 

CS Asterisk 


recv_pace : 

0 

No Recv Pace 



1 

Xon/Xoff Recv Pace 



2 

TR(CD) Recv Pace 
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The above structure elements plus some firmware variables are represented in an 
assembly language structure as follows: 


con fig data STEUC 


; Structure defining con fig data area 

predef_val 

DB 

? 

;Used by firmare for con fig calls 

barrel _idx 

DB 

? 

;Used by firmware for config calls 

port 

DB 

7 

;Used by firmware for config calls 

taisc_l 

DB 

? 

; Miscellaneous configuration bits 

misc_2 

DB 

? 

; Miscellaneous configuration bits 

baudjpate 

DB 

? 

;Baud rate 

parity 

DB 

? 

; Parity and checking 

clock 

DB 

? 

;Clock source 

asterisk 

DB 

? 

;Control line asterisk 

recvjpace 

DB 

? 

; Receive pacing 

dev token W 
config_data ENDS 

? 

;Used by firmware for config calls 


A Microsoft C language compatible call is now described. The function is passed 
two parameters: 

- The port number (1 = Portl, 2 = Port 2) 

- A pointer to a data structure defined as above 

The function will fill in the structure provided by the caller with the 
configuration for the appropriate port . Note that the configuration information 
will reflect that as it currently exists in non-volatile memory, as is seen in 
the configuration memu. 


TRUE 

mu 

1 

FALSE 

EQU 

0 

SUCCESS 

EQIJ 

0 

DHP RELEASE DEVICE 

EQU 

3 

BMP GDEV 

EQU 

1 

DHP~ GDTOK 

EQU 

14 

VERIFY CODE 

EQU 

14 

CONFIG CODE 

EQU 

1 

START DRIVER CODE 

EQU 

13 


DGROUP GEOUP DATA 

DATA SEGMENT WORD PUBLIC • DATA • 

ASSUME DS: DGROUP 


hpibdev 

flies 


DB 'HPIBDEV' ,0 

PUBLIC fit es 
DW ? 


;HPIB device name string 
; Firmware ES saved here 


DATA ENDS 
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PGBOUP 

GROUP PROG 


ASSUME CS:firm Jumps ,DS: NOTHING 

firm Jumps 

SEGMENT BYTE AT OOOOH 


OBG 0425H 

dhpentry 

LABEL FAR 


ORG 042AH 

dhp driver 

LABEL FAR 


ORG 04SCH 

cnpjsntry 

LABEL FAR 

firm jumps 

EBBS 

PROG 

SEGMENT BYTE PUBLIC 'PROG' 

9 

ASSUME CS:PGROUP,DS:DGROUP,ES: NOTHING 


; char getjxmf ( port jam, scratch ) 


/* Beads current datacomm part number ' portjnm ' configuration 
information from CMOS ( configuration) memory into the scratch 
structure at DS:’ scratch’ . The configuration data area at ' scratch ' 
will hare all the Values needed to specify the datacomn 
configuration. These can be modified arid passed to the firmware 
datacomn driver to set a new configuration. Returns TRUE if 
successful in performing the operation , false otherwise. 


9 


getcfjxrgs 

STOIC 


; Stack structure for passed arguments 


W 

? 

; Callers BP 


m 

? 

; Callers return address 

portjnm 

m 

? 

;Port mother (1 » Portl , 2 » Port 2) 

scratch 

getcfargs 

m 

ENDS 

? 

; ' scratch ’ argument 
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PUBLIC get conf 

get_conf 

PROC 

HEAR 


PUSH 

BP 


MOV 

BP,SP 


MOV 

BX,[BP] . portjnan 


MOV 

DI ,[ BP] . scratch 


POP 

BP 


MOV 

ES,fw_es 


MOV 

[DI ] . predef _Va l ,3 


MOV 

[DI] .barrel idx,8 


SHL 

BLyl 


CMP 

BL,2 


JE 

port one 


MOV 

BL,U 

portjme 

LABEL HEAR 


MOV 

[DI] .port ,BL 


MOV 

AH,BL 


MOV 

AL y 04H 


PUSH 

AX 


MOV 

AX, 020 W 


PUSH 

AX 


PUSH 

DS 


PUSH 

DI 


LEA 

AXy[DI] .port 


PUSH 

AX 


MOV 

AX, 3 


PUSH 

AX 


CALL 

cnp entry 


CMP 

AX, SUCCESS 


MOV 

AX, TRUE 


JE 

get cf ok 


MOV 

AXyFALSE 

get_cf_ok 

LABEL HEAR 


RET 


getjsonf 

EHDP 



scratch ’ argument from stack 

; Initialize firmware ES register 
; Initialize the variables of the 
; con fig data area required by 
; con fig processing 
;Pcrt ID is 2 for port 1 

;Port ID is 11 for port 2 


;Port identification 

;04 for full duplex hardwired form 

,01 for personality ID, 02 for con fig 
; values are required 

; Segment of scratch data area 
; Offset of scratch data area 
; Pointer to start of config data area 

l Function code for CHPJZETJJEV JXJHFIG 

;Betums: AX * status , BX * fail reason 
;Cdll error if failures 
; Firmware call executed tfithout errors 

; Error during fimssare call 


CHANGING THE DATA COMM CONFIGURATION 


The configuration data structure initialized by the above function is used when 
reconfiguring the port with different baud rate, parity, handshaking and other 
parameters. The process of reconfiguration is as follows: 


1. Save a copy of this data area for later restoration of the original 
conf igurat ion . 

2. Change the appropriate structure parameters to reflect the desired 
new configuration. 

3. Call Verjconf to "obtain the firmware device token", "get the 
firmware device", and verify that the new configuration data area 
is valid. 
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4. If the data is a valid configuration for the port ( Ver_conf returns 
TRUE), call config to "attach the firmware datacomm driver", 
reconfigure the hardware, "start the firmware driver", and "release the 
firmware datacomm device" . 


The following function performs the verification process, returning TRUE if the 
configuration data structure represents a valid port configuration. 


; char veroonf ( vcjscratch ) 


/* Verifies the datacomn configuration data in the config jiata 

structure. Returns TRUE if configuration is valid, FALSE otherwise. 
An example of an invalid configuration would he 8 data bits with 
a parity other then " none The configuration should be checked 
for validity prior to attempting to configure a port using the 
config function. The configuration data structure to be 
Verified is located at DS: ’ Vc_scratch' */ 


3 


Vercf jaegs 

STEUC 



m 

? 


m 

? 

vcjscratch 

m 

? 

vercf jags 

ENDS 



PUBLIC ver conf 

verjsonf 

PRDC 

NEAR 


PUSH 

BP 


MW 

BP,SP 


•KSTfir 

m/y 

BI , [ BP] . vc scratch 


POP 

BP 


CALL 

get jit ok 


CALL 

getjddev 


MW 

ES,fw es 


PUSH 

DS 


PUSH 

DI 


MW 

AX , VERIFY CODE 


PUSH 

AX 


PUSH 

[DI]. devjtdken 


CALL 

dhp_driver 


CMP 

AX , SUCCESS 


JZ 

conf ok 


MW 

AX, FALSE 


JMP 

vconf done 

confok 

LABEL NEAR 


MW 

AX, TRUE 

Vconfjdone 

LABEL NEAR 


RET 


verjsonf 

ENDP 



; Stack structure for passed arguments 
;Callers BP 

; Callers return address 
; ' vcjscratch ’ argument 


scratch* argument from stack 

; Obtain the firtm&zre datacomn device token 
;Get the firmware datacomm device 
initialize firmware ES register 
; ’ vc_scratch ’ segment 
;* vcjscratch’ offset 
; Firmware driver function code 

yDevice token - set up using ’ get jconf* 

; call prior to ’ verjeonf* 

;Call firmware datacomn driver - returns 
; AX * status , BX * fail reason 


; Configuration was bad 


; Configured ion was valid 
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getjttok 

PRDC 

NEAR 

; Obtain dataconm device token. Saves 




; the token in the con fig data area. 


HOF 

RS,fii es 

; Initialize firmaare ES register 


XOR 

AX, AX 



MOV 

AL,[DI] .port 



PUSH 

AX 

;Port ID (2 * Portl, 11 * Port 2) 


MOV 

AX, IMP GDTOK 



PUSH 

AX 

; Device handler function code 


CALL 

dhpjentry 

; Token returned in BX 


MW 

[DIJ. dev token, BX 



BET 



get_dtok 

ENDP 



get _ddev 

PRDC 

NEAR 

;Get the datacomn device allowing for 




; exclusive access. 


MOV 

ES es 

; Initialize firmware ES register 


PUSH 

[ DI ]. ctev token 



MOV 

AX,DHP GDEV 



PUSH 

AX 



CALL 

dhpjentry 



RET 



getddev 

ENDP 




The following function performs the actual port configuration and leaves the 
port operational from the firmware standpoint. It should be preceeded by the 
Verjconf call and only called if the Verjsonf call returns TRUE. 


; con fig ( cfjscratch ) 


/* Attaches the firmware datacomn driver, configures the datacomn port 
using configuration data structure at DS: ' cfjscratch' , then starts 
the firmaare datacomn device driver for the port. 

The attach call initializes the driver so that the configuration is 
active. It is necessary to start the datacomn device driver 
follotfing a configuration call in order to have the configuration 
changes take effect. The ' get_conf ' function should be used to 
initialize the configuration data area prior to modification of 
variables in this area for the neta configuration. 

Returns TRUE if no error tacts encountered during calls to the 
firmware, FALSE otherwise */ 


configjzrgs STEUC 

m ? 
m ? 

cfjscratch W ? 
configjzrgs ENDS 


; Stack structure for passed arguments 
; Callers BP 

.Callers return address 
; ' cfjscratch ' argument 


7-45 




Programming the HP 150 


PUBLIC canfig 
config PROC NEAR 
PUSH BP 
HOP BPySP 

MOP DI ,[BP] .cf scratch ; ’ cf scratch' argument from stack 

POP BP 

; Attach the firmware datacam driver - 
; initializes the driver so that the 
; configuration is active. 


HOP 

ES,fW es 

; Initialize firmware ES register 

XOR 

AXyAX 


MOP 

ALy[Dl] .port 

;Port id word (2 » Portl , 11 * Port2) 

PUSH 

AX 


HOP 

AX, 2 

; Point-to-point firmware driver 

PUSH 

AX 


HOP 

AXylO 

; Firmware driver function code 

PUSH 

AX 

; (DHP AETACH DRIVER) 

CALL 

dhp entry 


CMP 

AX, SUCCESS 


JHE 

con f error 

;Configure the datacortm port. 

MOP 

ESyfw es 

; Initialize firmware ES register 
; ' cf scratch ' segment 

HJSH 

DS 

PUSH 

DI 

; ' cfjBcratch' offset 

HOP 

AX , CONFIG CODE 

; Firmware driver function code 

PUSH 

AX 


PUSH 

[DI]. devjtdken 


CALL 

dhpjlriver 

;Always returns success 
; Start the firmware datacoma driver 

MOP 

ESyfw es 

; Initialize firmware ES register 

MOP 

AX, ST ART DRIVER CODE 

PUSH 

AX 

; Firmware driver function code 

PUSH 

[DI ] . devjtdken 

; Device token from scratch area 

CALL 

dhpjlriver 

; Always returns success 

CALL 

rel ddev 


MOP 

AX, TRUE 

;Ho error during attachment 

JMP 

config jdone 


conf_error LABEL HEAR 

MOP AX, FALSE 

config done LABEL HEAR 
RET 

config EHDP 


; Error while trying to attach driver 
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vel_ddet> 

PROC 

NEAR 

; Release the datacomn device 


new 

R5 } fe_ea 

; Initialize firmware £5 register 


PUSH 

[DIj.dev token 



¥09 

AX,DHP RELEASE DEVICE 


PUSH 

AX 

; Function code for firmware dev handler 


CALL 

dhp_entry 

~ 


RET 



reljddev 

ENDP 



PROG 

ENDS 




END 




RESTORING THE ORIGINAL CONFIGURATION 

It is important for applications which modify a port’s configuration to restore 
the original configuration prior to termination. Note that the above calls do 
not change the configuration reflected in the port conf iguration menus. If the 
ports are not restored to their originally configured state, their actual state 
will not correspond with that specified in the menus until the next system hard 
reset . 

This applies to programs which access the data communication controller and 
associated hardware directly. Programs which modify configuration should 
include the following operations to ensure the hardware is reconfigured prior to 
program termination. 

At program initialization: 

1. Call getjconf to read the initial configured state. 

2. If the program is going to use the con fig function to reconfigure 

the port, rather than going to the hardware directly, the configuration 
data area should be saved. 

At program cleanup: 

1. If the program used the config function to change the initial 
configuration, the configuration data area as saved at initialization 
should be restored. 

2. The verconf function is called to obtain the firmware device 
token and get the firmware device. It also verifies the config 

data area as being valid (which it should be - it has not been changed) . 

3. The config function is called to actually restore the initial 
configuration as reflected by the config data area. 
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Data Comm Control Functions 

The MS-DOS I/O Control For Devices System Function Call implements some special 
data comm control functions on the HP 150. Data communications data I/O using 
the MS-DOS Read and Write functions on C0M1 or COM2 devices has been described 
earlier in this section. In addition to some special control functions, 
alternative and possibly preferable data I/O methods are described here. 


IOCTL READS FOR INPUT 

In addition to using the MS-DOS Read From a File/Device System Function (3FH) 
input may be accomplished through the I/O Control For Devices Function, request 
2: "Read bytes from device control channel". Data channel bytes are returned 
for the COM devices. There are two principal advantages to input in this 
manner. First, the call gets any characters already received by the system 
without waiting for additional data (even if the requested number of bytes are 
not returned). Second, the call provides for optimal performance without having 
to put the device in "RAW" mode. The caller should check the AX register when 
MS-DOS returns (as specified for the function) to determine the number of bytes 
transferred. 

An example of IOCTRL data input is shown below. It uses the doscall function 
previously described in this section. 


Mefvrw lOCJEAD 0x4402 

int ccmjpeco ( handle, buffer, length ) 

f* Beads information from the datacam device ( CONI /COM 2 previously 
opened, file handle ’handle’) into a character buffer at ’buffer’ . 
Will read a maximum of ’length' bytes. Returns nuniter of bytes 
actually read (0 for none read) * / 

int handle; 
char * buffer; 
int length; 

{ 

doscall ( IOC READ , handle, length, buffer ); 
return ( (dc ret. ah < < 8) + dc_ret.al ); 

) 


SPECIAL COM FUNCTIONS IMPLEMENTED THROUGH IOCTL WRITE REQUEST 

The MS-DOS I/O Control for Devices System Function with Request 3: "Write to 
device control function" is used to implement a set of sub-functions for 
datacomm control. The defined sub-functions are: 
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( 8 , 1 ) 

( 8 , 2 ) 

(8,3) 

(8,U) 

(8.5) 

(8.6) 

(8.7) 

(8.8) 


- Set 7~bit (normal) mode for both transmit and receive 

- Set 8-bit (binary) mode for both transmit and receive 

- Set transparent (monitor) mode 

- Disable transparent (monitor) mode 

- Modem disconnect 

- Send break 

- Fast buffer send 

- Reset data comm 


The functions are specified with a two-byte identifier whose first byte is 8 to 
differentiate them from control requests to other devices. They are initiated 
by performing the MS-DOS I/O Control for Devices System Function with request 3. 
The buffer specified by the MS-DOS function (DS:DX) should contain the function 
code. For example, to send a break: 

doscall ( 10CJ?RITE 9 handle 9 length 9 &sub function ); 
where: 

IOC WRITE is defined as 4U03 Hex 


and: 


handle ~ device handle from device open call 

length = 2 (sub- function number length) 

sub function = 0807 Hex 

Note that function (8,7) is a special case, described below. 


The following definitions are in order: 

BINARY MODE The eighth bit is not stripped from the data stream of received 
characters. In non-binary mode, either 7 or 8 bits are received as configured 
for the port (in the configuration menu). That is, when the port is configured 
for 7 data bit operation (in the config menu) , the eighth data bit (parity) is 
masked. In binary mode, the 7/8 data bits configured state is effectively 
overridden and a full 8 data bits are returned. The eighth bit will be the 
parity bit if the port is configured for 7 data bits in the config menu. 

TRANSPARENT MODE In transparent mode, control characters normally resulting 
in some action being performed by the firmware datacomm driver are sent through 
as data instead. For example, if ENQ/ACK or X0N/X0FF hanshaking for the port is 
enabled in the conf iguration menu for the port, placing the port in transparent 
mode effectively disables the handshaking from taking place. The handshaking 
settings in the configuration menus are not altered however. Both receive and 
transmit handshaking are effected. In addition, transparent mode causes parity 
checking to be disabled. 

SEND BREAK The transmit data line is driven active (on) for 210 milliseconds. 
This is commonly used to signal a special condition to the host. 
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DISCONNECT MODEM Commonly used to cause a modem attached to the port to go 
off-line. The Terminal Ready control line output is driven inactive for two 
seconds . 

RESET DATA COMM This function disables transparent mode and sets 7 bit 
(normal) mode. It has no other effect. 


FAST BUFFER SEND FOR OUTPUT 

For improved performance over the "Write to a File/Device" MS-DOS System 
Function for data output to the communications ports, a "fast send" I/O Control 
for Devices sub-function is offered. This sub-function is implemented in a 
manner similar to the "send break" call above however the buffer pointed to by 
DS:DX is slightly different. In addition to the dub-function number, three 
words follow it. The buffer structure for fast send is: 


struct fcsjbuftem { 

int fcode; /* sub-ftmction number 0807 Hex */ 

int seq_offset ; /* send data buffer offset address * f 

int seqjzegment; /* send data buffer segment address */ 
int count; /* length of send data buffer (bytes) */ 

); 


So a Microsoft C language compatible function to implement the fast send 
sub-function can be defined as follows: 


comjsend ( handle , buffer , length ) 

/* Using " fast send buffer" function of IGCTRL for datacomn device to 
send ' length ' bytes from 'buffer' to datacomn output channel with a 
handle of 'handle' . */ 

int handle; 
char * buffer; 
int length; 

( 

fcsjntf. fcode * 0x0807; 
fcs_buf .seqjoffset » buffer; 
fcsjmf . seq_segment * dseg; 
fcsjmf .count ■ length; 

doscall ( IOC WRITE , handle, 8, &fcs buf ); 

) 
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where: 

IOC WRITE is defined as 4403 Hex 


and: 


handle = device handle from device open call 

buffer = address (offset) of buffer containing send data 

length = number of bytes in buffer 

deeg is equal to the applications data segment register (DS) 
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HPIB INTERFACING 


WARNING 


This facility is meant for use with NON-DISC devices. Templates can interfere 
with the disc driver used by the MSDOS file system. In general, problems can 
occur if any action on the bus changes conditions at a disc drive. For example, 
since a UNIVERSAL DEVICE CLEAR resets the head on an 82905 drive, it should not 
be used. Let the user beware. 


Limited HPIB Driver Functionality 

It should be understood that the HP 150 does not implement the full set of HPIB 
functions through its firmware and as such has limited capabilities in an 
instrument -control environment. In general the firmware -based HPIB driver does 
not support and activity which may be initiated by a peripheral. 

The computer peripherals on the HP 150 (discs, plotters, printers etcetera) are 
slave devices to the HP 150, which acts as a controller at all times. The HP 
150 initiates all HPIB operations. The limitation is a firmware restriction, 
the HP 150 has a full hardware implementation of the HPIB standard. Therefore 
it may be necessary to write RAM-based drivers which deal directly with the HPIB 
controller hardware to support certain HPIB configurations. 

Specifically the following conditions are not supported by the HP 150 firmware 
interface : 

- SRQ (Service Request) Function 

- TRIGGER Function 

- Multiple controllers 

- Transactions between other devices on the same bus 


Opening the ’’HPIBDEV” Device 

MSDOS functions are called by placing parameters in registers and executing a 
software interrupt 21 (hexadecimal). Controlling the HPIB device requires 
familiarity with two MSDOS functions. The “OPEN" function provides access to 
the HPIB driver. Once the driver is available, the "I0CTRL" function specifies 
the actions to be performed on the HPIB. 

The OPEN function returns a "file handle" that is used by the I0CTRL function. 
To OPEN the HPIB device, set up the registers as follows and perform a software 
interrupt 21 hexadecimal. 

AH = OPEN function number = 6 1 (3Dh) 

AL = access requested = 0,1, or 2 

DS,DX -> the ASCII name of the device = HPIBDEV 
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HPIB Control Calls 


MS-DOS IOCTRL FUNCTION CALL. Now that the HPIB device is opened, the IOCTRL 
function is used to control the HPIB. The function IOCTRL requires: 

AH - IOCTRL function number = 68 (44h) 

AL = subfunction number = 3 

BX = file handle returned by OPEN function 
CX = count of bytes in the CONTROL BLOCK 
DX,DX -> the CONTROL BLOCK 


CONTROL BLOCK FORMAT. The CONTROL BLOCK has the following format: 


Parm/Ret 

SIZE 

DESCRIPTION 

Parm 

word 

Function 

high byte = 0 (numbers are in decimal) 
low byte = use of Control Block 

17 = Perform this new template 

18 = Continue this template 

— used to recover from a 
--parallel poll 

Return 

word 

Status of function 

0 = Success 

4 = Busy (try NEW function 

again) 

6 = Timeout Error 

7 = EOI Error 

8 = Bus Error 

9 = Poll Error 

10 = Undefined Error - HPIB bus 

protocol error. 

11 = Overall Timeout Error 

Parra 

word 

Data Buffer Length 

Return 

word 

Number of data bytes sent or received 

Parm 

word 

Offset of Data Buffer 

Parm 

word 

Segment of Data Buffer 

Parm 

word 

Offset of Template 

Parm 

word 

Segment of Template 

Return 

word 

Return Template Pointer 

Parm 

word 

Overall Time Limit in milliseconds 

Parm 

byte 

HPIB Device address 

Parm 

byte 

HPIB Unit address 
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CONTROL TEMPLATE FORMAT . The template is a series of commands, and 
optionally, data bytes to the HPIB driver. Four types of commands exist with 
the high two bits of the command determining the type. The low 6 bits are 
qualifiers that further identify the command. 

76543210 


I I I I I I I I I 

| command type | SBUF | PPE | E0I | TERM | UNIT | ADDR | 

I I I I I I I I I 


The following equates are used in the sample templates to denote command type. 

Template Commands (bits 6,7) 

SET_VALUE = 0 changes a configuration value in the HPIB driver. 

RECEIVE = 040h indicates data should be read. The number of bytes read 

and where they are placed is determined by the lower 6 
bits of the command. See the qualifiers described below. 
If the SBUF bit is clear, then one data byte is read and 
it is placed at the next location in the template. 
Regardless of the state of SBUF, the next byte is not 
considered a template command. 

SEND f 08 Oh indicates data should be sent. The number of bytes 

transmitted and where they are coming from is determined 
by the qualifiers. 

CONTROLLER = 0C0H indicates the following byte (the controller command) 

should be transmitted with the attention (ATN) line high. 

Some of the controller commands are: 

UNTALK = 5Fh 

UNLISTEN = 3Fh 

TALK = 40h 

LISTEN = 20H 

The value of a command is created by "0R"ing the equates of the command types 
mentioned above with the following qualifiers. 

NOTE 

Terminator and time unit are carried from one template to another. 


Qualifiers to Commands 


-—ADDRESS = 1 


(bit 0) 
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When the CONTROLLER command has the address bit set, the drive address is "0R"ed 
with the following byte (the controller command). The address bit cam be used 

with a SET VALUE command to specify what HPIB device address should be used for 

all the operations specified in the template, otherwise the address specified in 
the CONTROL BLOCK is used. 

UNIT * 2h (bit 1) 

When the CONTROLLER command has the unit bit set, the unit address is "0R”ed 
with the following byte (the controller command) . The unit bit can be used with 
a SET VALUE command to change the HPIB unit address used with all the following 
template commands. (The default unit address is the one specified in the 
CONTROL BLOCK.) 

TERM = 4h (bit 2) 

The TERM bit implies the terminator character is of relevance when receiving 
characters. When used with SET VALUE, the following byte is the terminator 
character. When used with RECEIVE, the terminator character previously 
specified will denote the last character to be read. 

NOTE 

SET_VALUE + EOI + TRM => Read until TRM character, or EOI is received. 

EOI = 8h (bit 3) 

The EOI bit is used with RECEIVE to specify that with the last data byte read, 
an EOI is expected. If EOI expectancy state is not set correctly, an error is 
reported. Set Value + EOI => next byte in template is ignored and EOI should be 
ignored for the rest of the template. 

PPE = lOh (bit 4) 

PPE is used with SET VALUE to specify what devices the parallel poll should be 
looking for a response from. The following byte indicates the devices. PPE is 
used with disc drives. The PPE qualifier with RECEIVE, SEND, or CONTROLLER 
indicates a parallel poll will be performed before the command is executed for 
the current device id. 

SBUF = 20h (bit 5) 

The SBUF bit is used with RECEIVE or send to specify that a buffer rather than a 
single byte is to be transferred. The buffer offset address and the buffer 
segment address are always taken from the CONTROL BLOCK. When SET VALUE and 
SBUF are used, the next byte is the amount of time the HPIB driver waits for a 
single character before going into interrupt mode. The time unit is " 10 

microseconds . 
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SAMPLE IDENTIFY TEMPLATES. On an identify command, two data bytes are 
expected with the EOI line asserted after the second data byte is received. The 
identify command is IDENTIFY_SECONDARY = 60h. The first template reads the data 
bytes into the buffer specified in the CONTROL BLOCK. The second template 
places the data bytes in the template itself with labels D1 and D2 allowing easy 
access to the data. 

IDENTIFY TEMPLATE #1 

DB CONTROLLER 
DB UNLISTEN 
DB CONTROLLER 
DB UNTALK 

DB CONTROLLER (or) ADDRESS 
DB IDENTIFY_SECONDARY 
DB CONTROLLER 
DB LISTEN + POC 
DB RECEIVE (or) EOI (or) SBUF 
DB 0 - dummy byte 

DB CONTROLLER 
DB UNTALK 
DB CONTROLLER 
DB UNLISTEN 

DB END_DATA -end of template 
IDENTIFY TEMPLATE #2 



DB 

CONTROLLER 

- 

CO 


DB 

UNLISTEN 

- 

3F 


DB 

CONTROLLER 

- 

CO 


DB 

UNTALK 

- 

5F 


DB 

CONTROLLER (or) ADDRESS 

Cl 


DB 

IDENTIFY SECONDARY 

60 


DB 

CONTROLLER 

- 

CO 


DB 

LISTEN + POC 

- 

3E 


DB 

RECEIVE 

- 

40 

Dl: 

DB 

? 

-received byte - 



DB 

RECEIVE (or) 

EOI 

68 

D2: 

DB 

7 

-received byte 

? 


DB 

CONTROLLER 

- 

CO 


DB 

UNTALK 

- 

5F 


DB 

CONTROLLER 

- 

CO 


DB 

UNLISTEN 

- 

3F 


DB 

END DATA 

-end of template- 

00 


- CO 

- 3F 

- CO 

- 5F 

- Cl 

- 60 

- CO 

- 3E 

- 63 

- 00 

- CO 

- 5F 

- CO 

- 3F 

- 00 
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SAMPLE READ/WRITE BUFFER TEMPLATES. The following templates assume the 
buffer specified in the CONTROL BLOCK contains/receives the data. 

BLOCK TRANSFER "IN" TEMPLATE 


DB 

SET_VALUE (or) TERM (or) EOI - 

oc 

DB 

? -last data expected- 

FF 

DB 

CONTROLLER 

- 

CO 

DB 

UNTALK 


5F 

DB 

CONTROLLER 

- 

CO 

DB 

UNLISTEN 

- 

3F 

DB 

CONTROLLER (or) ADDRESS 

Cl 

DB 

TALK 

- 

ho 

DB 

CONTROLLER 

- 

CO 

DB 

LISTEN + POC 

- 

3E 

DB 

RECEIVE (or) 

SBUF 

60 

DB 

X 

-dummy byte- 

X 

DB 

CONTROLLER 

- 

CO 

DB 

UNTALK 

- 

5F 

DB 

CONTROLLER 

- 

CO 

DB 

UNLISTEN 

- 

3F 

DB 

END-DATA 

-end of template- 

00 


[ TRANSFER "OUT" 
DB CONTROLLER 

TEMPLATE 

CO 

DB 

UNTALK 

- 

5F 

DB 

CONTROLLER 

- 

CO 

DB 

UNLISTEN 

- 

3F 

DB 

CONTROLLER 

(or) ADDRESS 

Cl 

DB 

LISTEN 

- 

20 

DB 

CONTROLLER 

- 

CO 

DB 

TALK + POC 

- 

5E 

DB 

SEND (or) SBUF 

AO 

DB 

X 

-dummy byte- 

X 

DB 

CONTROLLER 

- 

CO 

DB 

UNTALK 

- 

5F 

DB 

CONTROLLER 

- 

CO 

DB 

UNLISTEN 

- 

3F 

DB 

END DATA 

-end of template- 

00 
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HPIB Interface Example (9111A Graphics Tablet) 

The following is an example of using the MS-DOS I/O Control System Function 
accessing the "HPIBDEV" device to interface an HPIB peripheral. In this case it 
is a 9H1A Graphics Tablet which is interfaced. The example is written in the C 
language . 

The routines obtain and print stylus position and status information. The 
routines use the doscall function previously described (see "MS-DOS System 
Function Calls from the C Language"). The routine which returns the DS (data 
segment) register contents is described following the C code. 

Note that this example for the sake of compactness contains minimal error 
checking. Error checking enhancements should be included for reliable 
f unct ional ity . 


/ 


********************* ********************************************************* 


Mefine IO_DEVICE_CTBL 0x4403 

Me fine CTRL_FUNCTION 17 

Mefine TIME LIMIT 0x30 


Mefine DEV_ANDJIN, 

Mefine SET VALUE 
Mefine RECEIVE s 
Mefine SEND 
Mefine CONTROLLER 

Mefine UNTALK 
Mefine UNLISTEN 
Mefine TALK 
Mefine LISTEN 

Mefine ADDRESS 
Mefine UNIT 
Mefine TERM 
Mefine EOI 
Mefine PPE 
Mefine SBUF 

Mefine END_DATA 
Mefine POC 
Mefine MAXLENGTH 
Mefine LINEFEED 
Mefine EOF 
Mefine ESC 0x13 

int tab ^handle; 
char buf[12j ; 


ADDRESS 0x0006 

0x00 

0x40 

0x80 

OxcO 

0x5f 

0x3f 

0x40 

0x20 

0x01 

0x02 

0x04 

0x08 

0x10 

0x20 

0x00 

Oxle 

128 

0x0a 

Oxff 


/* MS-DOS I/O Control for Devices 
System Function code . sub-function 
3 (Write to Device Ctrl Channel ) */ 
/* Control Block function - perform 
this new template */ 

1* HPIBDEV I0CTRL Call time limit */ 

/* 9111A HPIB address code */ 

/* CONTROL TEMPLATE COMMANDS */ 


/* HPIB CONTROLLER COMMANDS */ 


/* HPIB CONTROLLER COMMAND QUALIFIERS */ 


7-58 



Programming the HP 150 


struct dc_ret_tem { /* 'dosoall ' return parameter structure * / 

char all 
char ah; 
char bl; 
char bh; 
char cl; 
char ch; 
char dl; 
char dh ; 

); 

extern struct dc_ret_tem dc_ret; 

static int hpib Ctrl block[ 11] 3 { 

CTRL FUNCTION, 

0 , 0 ~ 

0 , 0 , 

0 , 0 , 

0 , 0 , 

TIMELIMIT, 

DEV ANDJJNIT ADDRESS 

); 


f* Control block used for MS-DOS */ 

/* I/O Control System Function call * / 
/* to "HPIBDEV" */ 


idefine CTRL BLOCK_COUNT 22 /* length of abooe block */ 

static char write template] 15 ] e { /* Template for ASCII writes (the */ 

CONTROLLER , /* only kind ) to the tablet */ 

UNTALK, 

CONTROLLER, 

UNLISTEN, 

CONTROLLER + ADDRESS, 

LISTEN, 

CONTROLLER, 

TALK + ROC, 

SEND + SEUF, 

0 , 

CONTROLLER, 

UNTALK, 

CONTROLLER, 

UNLISTEN, 

END DATA 
)i ' 
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static char readjrinary] 15] m { /* Template for binary reads from tablet */ 

CONTROLLER, 

UNTALK, 

CONTROLLER, 

UNLISTEN, 

CONTROLLER + ADDRESS, 

TALK, 

CONTROLLER, 

LISTEN + POC, 

RECEIVE + SWF + BOI, 

0, 

CONTROLLER, 

UNTALK, 

CONTROLLER, 

UNLISTEN, 

END DATA 
); " 

static char read ascii] 19] * { /* Template for ASCII reads from tablet * / 

SET VALUE + EOI + TERM, 

LINEFEED, 

SET VALUE + SWF, 

B0F~ 

CONTROLLER, 

UNTALK, 

CONTROLLER, 

UNLISTEN, 

CONTROLLER + ADDRESS, 

TALK, 

CONTROLLER, 

LISTEN + POC, 

RECEIVE + SWF + TERN, 

0, 

CONTROLLER, 

UNTALK, 

CONTROLLER, 

UNLISTEN, 

END DATA 
); ~ 
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j********************************************** ********************* ********* j 

main () 

{ 

int x , y, status; 

if ( tab_init( ) ■■ 1 ) { f* initialize graphics tablet */ 

while ( kbkitO ■■ 0 ) { f* Continuously request stylus poaiti 

and status from tablet until 
keyboard is hit */ 

getjcyjstatus ( &x, Ay, Astatus , tab_handle ); /* get data */ 

printf ("x: %r y: %x status: %x\r" , x, y> status ; /* display it */ 

)i 

); 

xenixclose (tab handle ); /* close the tablet */ 

) 

^* ****************************************************************** ********** 
char tab_init( ) 

/* Initializes the graphics tablet by opening the device and checking 
for the tablets response to the Identify function. Returns 0 if the 
tablet did not identify correctly , returns 1 otherwise */ 


{ 

tab_handle « open tablet (); /* open the tablet and get handle */ 

Write block (tab Tiandle, "01;" , 3); f* Perform tablet Output Identity */ 
a read. ( tab_hamHe , buf); /* operation /* 

if (buf[0] /* ' 9’ ) /* Did tablet identify itself ? * / 

printf ( "9111A Graphics Tablet did not ident if y\r\n " ) ; 

/* Rote - HPIB appears to "hang" when 
01 sent to a non-existant tablet */ 

return ( 0 ); 

} 

else 

return ( 1 ); 


j*** ************************************************************** ************ 

int openjtablet () /* Opens the device "HPIBDSV" and returns handle 

Rote - no error checking ! * / 

{ 

hpib_ctrl_block[5] ■* hpib_ctrl_block[ 7 ] * datajseg (); 
return (xenixopen ( "HPIBDEV" , 2) ) ; ” 

) 
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j**************************************************************************** 

int xenixopen ( filejname , access) /* open device "filejtame" for mode 

" access " (read/write/bcth) */ 

char *file_name ; 
int access ; 

f 

int ax, dummy ; 

ax * 0x3d00 + access; 

doscdll (ax, dummy, dummy, file_name); 

return ( ( dc ret. ah << 8 ) + dc ret. al ); /* return handle */ 

) 

^******************************************* ******************************** j 

write J>lock (handle, buffer, count) /* Writes "count" ASCII bytes from 

"buffer to device "handle" using 
MS-DOS Write to a File/Device 
System Function Call /* 

char * buffer; 

( 

hpib_ctrl_block[ 2] = count; /* Update the control block */ 

hpib_ctrl_block[4] = (int) buffer; /* with the passed parameters * / 

hpib_ctrl_block[S] = (int) Write ^template; 

f* Perform the Write to a File/Device System Function Call */ 
doscdll (10 DEVICE CTRL , handle, CTRL BLOCK COURT, hpib Ctrl block); 

} 


^****** ********************************************************************* 
ajpead ( handle , buffer) /* Reads a block of ASCII data from the specified 

device. */ 


char * buffer; 


{ 

hpib_ctrl_block[2] * MAXLENGTH; /* Update the control block with */ 

hpib_ctrl_block[4] ■ (int) buffer; /* passed parameters */ 

hpib_ctrl_block[6] ■ (int) readjzscii; 


/* Perform the read * / 


doscdll (10 DEVICE CTRL, handle, CTRL BLOCK COURT, hpib Ctrl block); 

) 
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/*********** ********* ****** ************************************************* 
get_x _y_status ( x, y, status , tab handle) 

/* Beads the stylus position and status from the tablet. Beads until six 
bytes of data are received. Parses the address and status variables 
from the return string. Bote that due to timing considerations , only 
five bytes are received in some instances , followed by seven next time */ 

int *x y *y, * status ; 
int tab handle; 


i 

int my_x, my_y, my_status ; 


while (b_read (&my_x f tab handle) !*>6); /* Read until valid data */ 

*x * ( (my_x > > 3) & Oxff) + (my_x << 8); /* Convert to Ibyte, kbyte * / 

*y = ((myjf >> 8) & Oxff) + (myjf << 8); 

* status = ( (my status >> 8) 6 Oxff) + (my status < < 8); 

) 


j ****** ******* Aft* Hr ********************* ft************************************ 

int b read ( buffer , handle) /* Performs a binary data read from the tablet 

until an BOI character is detected. Returns 
the lumber of bytes read from the tablet */ 

int * buffer; 
int handle; 


hpib_ctrl_block[ 2] 
hpib_ctrl_block[ 4] 
hpib_ctrl_block[ 6] 


~ 6; /* Update the control block with */ 

3 ( int) buffer; /* passed parameters */ 

3 (int) readjnnary; 


/* Perform the read * / 


doscall (10 DEYICE CTRL , handle , CTRL_BLQCK_COUWT , hpib ctrlJblocP, ) ; 
return ( hpiU ctrl block[3] ; 

} 


f ******* ****************************************************************** 

xenixclose (handle) /* Close device with handle of ” handle " * / 
int handle; 

{ 

doscall (0x3e00, handle) ; 

} 
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; unsigned int datajaegO 
i 

/* returns current DS register contents * / 

PUBLIC data seg 
datajseg PROC HEAR' 

MOV AX,DS 

RET 

datajseg ENDP 

PROG ENDS 
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ACCESSORY CARD INTERFACING 


Memory (Slot) Address Identification 

16 k of contiguous memory space is allocated to each of the two accessory slots 
on the HP 150. Associated with each slot is a hardware accessory card select 
line which goes active when a memory read or write occurs to the memory space 
allocated to that particular slot. The memory blocks are allocated to each slot 
as follows: 

Accessory Slot 1 90000H - 93FFFH 

Accessory Slot 2 A0000H - A3FFFH 

Through utilization of the slot select line, accessory boards using memory 
mapped I/O space may be designed to be slot independent. That is, their memory 
mapped space will reside within the absolute bounds as defined for the 
particular slot in which the card is installed. A firmware routine called the 
Option Handling Processor (OHP) has a function which will return the slot ID (1 
or 2) for a particular accessory, if that accessory is installed. Accessories 
with associated software wishing to utilize this function must have a unique id 
byte memory mapped to the base address of the l6K block. See the Accessories 
Subsystem discussion in Section 3 for more information. 

The following example shows how to obtain the memory segment address for an 
installed card given its specific id. 


ACC ID 

EQU 

000H 

;Put your accessory board id medber here 

GET~ TOKEN 

EQU 

007 H 

;0HP get slot token function code 

SL0T1 

Em 

00 1H 

;Slot one id token 

SLOT2 

Em 

002H 

;Slot two id token 

SI SBC 

sm 

09000H 

;Slot one RAM segment address 

S2 SEG 

Em 

OAOOOH 

;Slot two RAM segment address 

;MSDOS entry interrupt and function codes 

MSDOS 

Em 

021H 

;t!SD0S entry interrupt 

OPEN DEV 

Em 

03DH 

;Open device function code 

IOCNTRL 

sm 

044H 

;I/0 control for devices function code 

; MS-DOS System Function parameter 

equates 

INPUT 

Em 

000H 

;0pen device for input 

OUTPUT 

Em 

00 1H 

;0pen device for output 

BEAD 

Em 

002H 

;Read from device 
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DGROUP 

GROUP 

DATA 


DATA 

SEGMENT WORD PUBLIC 
ASSUME DS: DGROUP 

•DATA' 

OHP ENTRX 

LABEL 

DWORD 

: Opt ion handler processor entry point 

0HP~ OSET 

DW 

OOOCOH 

; Offset of option handler processor 

ohpZseg 

DM 

00040H 

; Segment of option handler processor 

HPIBDEV 

DB 

•HPIBDEV ,0 

; Firmware device name string 

FW_ES 

DW 

? 

; Firmware ES value 

DATA 

ENDS 

PAGE 



PGROUP 

GROUP 

PROG 


PROG 

SEGMENT BITE PUBLIC 

•FROG’ 


ASSUME CS:PGROUP,DS:DGROUP,ES:NOTHING 


GET_ACC_SEG - Get accessory slot segment address for given id. The 

firmware is called to locate which option slot contains 
the option hoard and the accessory slot RAM address 
segment pointer is set accordingly. 

Registers in: None 

Registers out: AX * 0 if accessory board with given id not found 

Address base pointer ( segment) if found 

Registers preserved: None 


PUBLIC GET ACC SEG 

GET ACCJSEG PROC NEAR 

CALL GETJS 

JNZ INITJRR 

MCV AX, ACC ID 

PUSH AX 

MOV AX, GET TOKEN 

PUSH AX 

CALL FAR PTR OHP 
OR AX, AX 

JNZ INIT_ERR 

MOV AX, SI SEG 

CMP BX,SWT1 

JNZ CHK S2 

RET 

CHK S2 LABEL NEAR 

MOV AX,S2 SEG 
CMP BX,SLOT2 

JNZ INITJBRR 

RET 

INIT ERR LABEL NEAR 

SUB AX, AX 

RET 

GET ACC SEG ENDP 


; Initialize hardware interface 
;Load firmware ES value 
;Junp if error 

;Load accessory board id manber 
;Load get token function code 

;Call firmware option handler 

;Jump if error 


; Store option board RAM segment 
; address depending on slot id 


; Error occurred 
;Plag error occurred 
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OHP - Par call to firmware option handler processor. 

This routine loads ES with the address of the firrmare extra seg 
and then does a long jump to the firmware OHP routine. When 
the OHP does a far return , control is returned to the caller 
of this routine. 

NOTE - The call to this routine must be a far call (32 bit ) 
Arguments in: 

All arguments to the OHP are pushed on the stack and are 
the callers responsibility. 

Return values: 

Values returned are specified by the OHP and depend on the 
OHP function executed. 

Registers preserved: Hone 


OHP 


PUBLIC OHP 

PROC FAR ;Par call to firmware OHP 

MOV ES,FW ES ;Load ES for firmware 

JMP mOED~FTll DGBOUP: OHP_EWFEI ; Intersegment indirect jmp to OHP 

RET ; Dummy return 


OHP EHDP 


GETJRS - Load and save firmware extra segment address. 

This routine opens a firmware device 1 HPIBDEV ' , reads four bytes 
from it which is a 32-bit pointer to a firmware information block , 
loads the firmware IBS Value from this information block , and 
stores the ES value for later firmware calls. 


3 


3 

Registers in: 


3 

Hone. 


3 

Registers out: 


3 

FF 

- Z: everthing O.K. , 

firmware ES Value stored 

3 


HZ: error in function calls , ES value not stored 

3 

Registers preserved: 


3 

BP, 

ES 


GET VARS 

STWC 


; Stack structure for temp variables 

FW FTR 

DD 

? 

; Pointer to firmware info block 

GET_VAI8 

ENDS 




PUBLIC GET ES 


GETJS 

PWC 

HEAR 

;Get and save firmware ES value 


PUSH 

ES 

;SaVe callers ES 


PUSH 

BP 

:Save callers BP 


SUB 

SP,4 

; Allocate space for temp variables 


MOV 

BP,SP 

; Initialize base pointer 


MOV 

AH, OPEN DEV 

;Open device 


LEA 

DX,HPIBDEV 

; name 'HPIBDEV' 


MOV 

AL, INPUT 

; for input 


INT 

MSDOS 



JC 

GET ERR 

;Jwnp if error on open 
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MOV 

BXyAX 


MOV 

AHJOCNTRL 


MOV 

AL,READ 


MOV 

CXy4 


LEA 

DX,[BP].¥W PTR 


INT 

MSDOS 


JC 

GET ERR 


CMP 

AX, 4 


JNZ 

GET ERR 


LBS 

BXjBP].FV PTR 


MW 

AX,ES:[BX]~ 


MOV 

FW BSyAX 


ADD 

SP~,4 


POP 

BP 


POP 

BS 


SUB 

AX, AX 


RET 


GEI_ERR 

LABEL 

NEAR 


ADD 

SPy4 


POP 

BP 


FOP 

BS 


OR 

AXyOFFFFH 


RET 


GETJBS 

ENDP 


PROG 

ENDS 



END 



;Get device handle for read 
;I/0 control for device 
;Read 

; four bytes 
; into temporary storage 
; from device handle in BX 
;Jump if error on read 
;Jtmp if four bytes not read 

;Load pointer to fu info block 
;Load firmware BS Value 
; St ore BS value 
;Release allocated stack space 
; Restore callers BP 
; Restore callers BS 
;Plag everything O.K. 

; Return to caller 

; Error occurred 
; Release allocated stack space 
; Restore callers BP 
; Restore callers BS 
;Set error flag 
; Return to caller 
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SECTION 


AGIOS FUNCTION CALL REFERENCE 



This section is a reference to the Alpha Graphics Input/Output System (AGIOS) 
set of function calls on the HP 150. 

AGIOS is a facility that lets you use system routines to perform tasks on the HP 
150 keyboard and display. They let you perform text and graphics mode 
operations on your display, let you define and use softkeys (function keys), and 
let you perform all touch screen operations. 


This manual contains information elsewhere pert inent to using the AGIOS function 
set. Section 5 , System Software, provides an introduction to the Alpha Graphics 
I/O System and includes a simple example of an AGIOS function call. Section 7, 
Programming the HP 150, describes a general AGIOS caller function for the C 
language. This function provides a relatively easy way for C programs (and 
programs in other languages with suitable modifications to the agios function) 
to invoke any AGIOS function. Section 7 also includes many examples of AGIOS 
calls from the C language . 
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SYNTAX USED IN THE AGIOS FUNCTION CALLS 


Each AGIOS function call is explained in detail on the succeeding pages. In 
order to clarify the information that you need to supply, a standard notation is 
used. Parentheses and positional notation is used as follows: 


FARM Indicates a single byte parameter. 

(PARM1,PARM2) Indicates two single byte parameters with parml in the high 

byte and parm2 in the low byte. 


( ,PARM) 


Indicates a single byte parameter in the low order byte of 
the word. The high byte is ignored. 


(PARM,) 


Indicates a single byte parameter in the high order byte of 
the word. The low byte is gnored. 


(PARM) 


Indicates a word (l6 bit) parameter. 


((FARM)) Indicates a double word parameter. Usually the first word is 

a data segment address and the second word is an offset 
address . 


Where applicable, the AGIOS call name is followed by the corresponding escape 
sequence. For example, one entry later in this section is: 

DEFINE TOUCH FIELD (ESC - z g) 

This indicates that the escape sequence which corresponds to the Define Touch 
Field AGIOS call is ESC - z g. 
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BATCH FUNCTION CALL 


A special function call is available which lets you execute a sequence of 
function calls automatically. Using this function call is especially convenient 
when you frequently perform the same set of AGIOS function calls. 

To "batch" function calls, you set up the sequence of AGIOS function calls in a 
command buffer. Then you issue the following batch function call using the 
command buffer as one of its parameters . 

(0, 0) Function code 

(BUFFER LENGTH) COMMAND BUFFER length (byte count). 

( (COMMAND BUFFER)) A pointer to the buffer containing the AGIOS function calls. 

The function calls are defined consecutively. Use the same 
parameter format as specified in this section for the 
individual function calls. 

A batch call is aborted when any of the function calls in the batch causes an 
error condition. Additionally, you cannot nest batch function calls (include 
them in the batch). 


Example : 

This example clears the alpha display by homeing up first, then clearing the 
display. Refer to the "H" and , " J" options of the "Execute Two Character 
Sequence" function call. 

The command buffer looks like this: 


Contents — > | 16 \ 0 | H | 16 \ 0 | J \ 


— > tO tl 


Byte 


t2 tl t4 t5 
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The assembler routine that sets up the command buffer and executes a batch call 
might look like this: 


CLS 

PUSH DS 


POP 

CMDSEG 


MOV 

AX,4403H 


MOV 

BX,1 


MOV 

CX,8 


MOV 

DX,offset BATCH 


INT 

21H 


BET 


CMDBUF 

DB 

16,0, 'H' ,16,0,' J 

BATCH 

DB 

0,0 

BUFLBH 

DW 

6 

CMDOFF 

DW 

CMDBUF 

CMDSEG 

DW 

0 


; Save DS an Stack 
; And Store it in Batch Buffer 

; I/O Control Write 
; Console Handle 
; Batch Buffer Length 
; Batch Conrnand Buffer 


; AGIOS Batch Conrnxnd 
; CMDBUF Len 6 Here 
; CMDOFP equates CMDBUF 
; Data Segment Dummy Value 
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VIDEO INTRINSICS 


The video intrinsics are a set of functions that may be used to update the 
state of the display. With the exception of the Write Line function, all 
intrinsics operate on a pre-defined subset area of the 24 by 80 character 
display. All row and column values are relative to zero. The upper left 
corner of the display is (0,0) and the lower right corner is (23,79)* 

A null data buffer pointer (segment = OFFFFH) will suppress the 
update operation for that data type . There is a one to one correspondence 
between the position of a data byte in its buffer and the character position 
that it will affect in the pre-defined update area, starting at the upper 
left corner, incrementing column position first and then row position. 

The ASCII data consists of the 8 bit HP Standard ASCII character 

code. The character set data consists of character set code characters as 

follows : 


CHARACTER CHARACTER 

CODE: SET SELECTED: 


% 

A 

B 

C 

D 

SPACE 


Hormal Roman 
Line Dreating 
Bold Face Roman 
Italic Roman 
Math 

No Change 


The enhancement data consists of enhancement code characters as 
follows : 


security off: 

0 

A 

3 

c 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 

N 

0 

security on : 

P 

Q 

R 

s 

T 

U 

V 

W 

X 

I 

z 

[ 

\ 

] 



half-bright | 









X 

X 

X 

X 

X 

X 

X 

X 

underline | 





X 

X 

X 

X 





X 

X 

X 

X 

inverse video \ 



X 

X 



X 

X 



X 

X 



X 

X 

blinking \ 


X 


X 


X 


X 


X 


X 


X 


X 


(A space, 20H, indicates no change to the current state.) 
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DEFINE AREA 


This function specifies the area to be operated upon by subsequent area 

update operations. 

(0, 1) Function Code. 

(LR-R0W,LR-C0L) Defines the lower right corner of the area to be operated 

upon. 

(UL-R0W,UL-C0L) Defines the upper left corner of the area to be operated 

upon. 

( (PREV-COORD) ) A pointer to a buffer where the previous area 

coordinates are returned . The format of the 

returned data is the same as the two input coordinates. 
This buffer pointer may be null. 


WRITE AREA 


This function writes data into the pre-defined display area. 

(0, 2) Function Code 

(DATA LENGTH) Length of the data buffers. 

( (ENH POINTER)) A double word pointer to a buffer of enhancement code 

characters to be used to change the enhancement state of 
the update area. 

((CHAR SET)) A double word pointer to a buffer of character set code 

characters to be used to change the character set state 
of the update area. 

((ASCII POINTER)) A double word pointer to the buffer of ASCII data to be 

written into the update area. 
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CLEAR AREA 


This function clears the most recently defined area to ASCII blanks (20H), with 
no enhancements set. 


(0, 3) 


Function Code 


ENHANCE AREA 

This function sets the enhancement state of the entire pre- defined display 
area to the specified enhancement . 

(0, k) Function Code 

(, ENHANCEMENT) An enhancement code character. 

READ AREA 

This function reads 

(o, 5) 

(DATA LENGTH) 

((ENH POINTER)) 

((CHAR SET)) 

((ASCII POINTER)) 


data from the pre-defined display area. 

Function Code 

Length of the data buffers. 

A double word pointer to the buffer that the enhancement 
data will be read into. 

A double word pointer to a buffer that the character set 
data will be read into. 

A double word pointer to the buffer that the ASCII data 
will be read into. 
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SHIFT AREA 


This function shifts the data in the pre-defined display area. 
Enhancements and character set are shifted with the ASCII data. Data shifted 
off sm edge of the update area is lost. 

(0, 6) Function Code 

(DATA LENGTH) Length of the data buffer. 

( (ENH POINTER)) A double word pointer to a buffer of enhancement codes to 

be used to enhance the remaining unshifted area. 

( (CHAR SET) ) A double word pointer to a buffer of character set code 

characters to be used to change the character set state 
of the remaining unshifted area. 

((ASCII POINTER)) A double word pointer to a buffer of ASCII data to be 

written into the remaining unshifted area. 

(DIRECTION, DIST) DIRECTION: 

0 = up 

1 = down 

2 = left 

3 = right 

DIST: 

The number of rows/columns to shift the current video data. 
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WRITE LINE 


This function writes a single row (or part of a row) in the workspace. Unlike 
Write Area, this intrinsic ignores the area bounds set by Define Area. If 
the position and length of the data are defined such that the right 
workspace boundary is violated, that portion of the data exceeding the boundary 
is ignored. No line wrap occurs. 

( 0 , 7) Function Code 

(WKSP-ROW,WKSF-COL) Defines the workspace relative position at which the 

data will be written. 

(DATA LENGTH) Length of the data buffers. 

( (ENH POINTER)) A double word pointer to the buffer of enhancement data to 

be written at the designated position. 

((CHAR SET)) A double word pointer to a buffer of character set code 

characters to be used to change the character set state 
of the update area. 

((ASCII POINTER)) A double word pointer to the buffer of ASCII data to be 

written at the designated position. 
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APPLICATION SOFTKEYS 


This section gives the AGIOS function calls that support Application Softkeys. 
You can access these softkeys by typing [Shift] [User System]. You can use 
ASCII and Extended Roman characters within Application Softkey labels. 


UPDATE SOFTKEY LABEL 


This function will update a softkey label and enhancement. 


( 0 , 8 ) 

( , NUMBER) 

( (DATA) ) 

( ,T0P ENH) 
( ,B0T ENH) 


Function Code 

Softkey Number (the softkey number is from 1 to 8 inclusive) 

A double word pointer to the buffer of ASCII data to be 
written into the label area. (16 bytes.) 

Enhancement code for the top half of the label. 

Enhancement code for the bottom half of the label. 


READ SOFTKEY LABEL 


This function gets the softkey number specified by the caller and then 
returns the softkey label and the enhancement code characters in two 
buffers . 


(o, 9) 

(, NUMBER) 
( (DATA) ) 


Function Code 
Softkey Number 

A double word pointer to the buffer which is for the ASCII 
data. 


((ENHANCEMENTS)) 


A double word pointer to the buffer which is for the 
enhancement code characters . 
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DISPLAY SOFTKEY LABELS 


This function displays the application softkey labels in the softkey window. 
(0,11) Function Code 
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CONTROL FUNCTIONS 


EXECUTE TWO CHARACTER SEQUENCE (ESC CHAR) 


(0,16) Function Code 

OP-CHAR The character equivalent of a 2 character escape sequence. 

Any operation characters are valid except for those that 
return data. The following list defines some of the most 
common ones. 


0 

1 

2 

3 

4 

5 
9 

6 
A 
B 
C 
D 
B 
P 
G 
H 
I 
J 
K 
L 
L 
P 
Q 
R 
S 
T 


Dump Alpha to Printer V 
Set tab V 
Clear tab V 
Clear all tabs X 
Set left margin Y 
Set xdght margin Z 
Clear margins [ 
Delay one second ] 
Cursor up b 
Cursor down c 
Cursor right f 
Cursor left g 
Reset terminal h 
Home down i 
Return j 
Rome up k 
Tab l 
Clear display m 
Clear line p 
Insert Line q 
Delete Line r 
Delete Character w/o Wrap s 
Insert Character w/o Wrap t 
Insert Character Off u 
Roll Up V 
Roll Down W 


: Next Page 

: Previous Page 

: Format Mode On 

: Format Mode Off 

: Display Functions On 

: Display Functions Off 

: Start Unprotected Field 

: End Protected Field 

: Enable Keyboard 

: Disable Keyboard 

: Modem Disconnect 

: Soft Reset Terminal 

: Home Up 

Back Tab 

: Display Softkey Def Menu 

: Exit Softkey Def Menu 

: Memory Lock On 

: Memoru Lot'k Off 

: Default ifl] Value 

: Default [f2] Value 

: Default [f3] Value 

: Default [f4] Value 

: Default [fS] Value 

: Default [16] Value 

: Default lf7] Value 

: Default If 8] Value 
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POSITION CURSOR (ESC & a) 


( 0 , 17 ) 


Function Code 


MODE 


(COLUMN) 

(ROW) 


Bit 0: 

1 ■ window row address 

0 * Workspace row address 

Bit 1: 

1 - relative row address 

0 * absolute row address 

Bit 2: 

1 = negative row address 

0 = positive row address 

Bit 3: 

1 - row address is valid 

0 = row address is not valid 

Bit 4: 

1 = window column address 

0 - workspace column address 

Bit 5: 

1 - relative column address 

0 = absolute Column address 

Bit 6: 

1 = negative column address 

0 * positive column address 

Bit 7: 

1 = column address is valid 

0 * column address is not valid 

An unsigned integer 
An unsigned integer 


8-12 



AGIOS Function Call Reference 


DEFINE ENHANCEMENTS (ESC & d) 


(0,18) 

Function Code 


SEC 

SEC: 

1 = on, 0 = 

off. 

ENH 

ENH: 

the ESC &d 

code character (S..0) 


CURSOR SENSE ABSOLUTE (ESC a) 

(0,19) Function Code 

( (BUFFER) ) A pointer to a buffer where two words are returned. The 

first word is the column number in binary and the second 
word is the row number in binary. 


CURSOR SENSE RELATIVE (ESC ') 

(0,20) Funct ion Code 

( (BUFFER) ) A pointer to a buffer where two words are returned. The 

first word is the column number number in binary and the 
second word is the row number in binary. 
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SET CURSOR TYPE 


This function sets the alpha cursor type. 

(0,21) Funct ion Code 

( ,'1'YPE) Alpha cursor type: 0 = underscore 

1 = inverse cell. 


READ CURSOR TYPE 


This function reads the alpha cursor type. 

(0,22) Function Code 

((BUFFER)) A pointer to a word location where alpha cursor type data is 

stored. 


READ TERMINAL CONFIGURATION 


This function reads the current terminal configurations. 

(0,24) Function Code 

((BUFFER)) A word pointer to the buffer where the current configuration 

is returned . 

When this function is complete, BUFFER contains: 

(,RRRRRTSP) R = reserved bits, 

T = set if touch screen off, 

S = set if softkeys on, 

P = set if remote port 2= 

(KEYBOARD LANGUAGE) 

(STRING LANGUAGE) 

(OP SYS DEVICE) Bits 0-2: addr. 0-7. 

Bits 3-15: dev. 0 = HP-IB, 1 « Accsy. 
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TOUCH SCREEN FUNCTIONS 


The touch features on the HP 150 can be programmed in a variety of ways. The 
two general types of touch operations are "Field" operations and "Row/Column" 
operations. These two types can be intermixed. 

Several of the touch screen function calls in this section assume keycode mode. 
Refer to "Keycode Modes" in Section 7 for information on this mode. 


FIELD OPERATIONS 


There are four types of touch fields you can define. They are: 

ASCII Fields: 

This mode is very similar to the User-Definable Softkeys (see Section h) . A 
buffer of ASCII characters is associated with a touch field. A response string 
of 0 to 80 ASCII characters is obtained by consecutive keyboard input 
operations. The first input obtains the first ASCII byte, and the second 
input obtains the second ASCII byte, etc. The response string is generated 
when the field is touched and should be indistinguishable from the typing of 
the same string from the keyboard. Auto-repeat is performed. 

Keycode Fields: 

Keycode fields require that you be in keycode mode (see "Keycodes", Section 7). 
The two data words of the response string are treated as a keycode and a 
qualfier and are processed by the regular keyboard routines. The final 
response to touch depends on the state and mode of keyboard processing. Touch 
simulates typing on the keyboard. Releasing simulates releasing your finger 
from the key. Auto-repeat is performed. 

Toggle Fields: 

The touch field is defined as a toggle switch. Touching the area toggles the 
field on and off. Whenever the field is touched, sensing information is 
passed to the application. The sensing information consists of three data 
bytes. The data is obtained by three consecutive keyboard input operations. 
The qualifier word of each data byte returned to the application has the 
touch screen ID. The three data bytes of sensing information are: 


01H - toggle on field report opcode 
dl - response string first byte 
d2 - response string second byte 
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02B - toggle off field report opcode 
dl - response string first byte 
d2 - response string second byte 

Hormal Fields: 

This type of touch field senses touch and/or release. The sensing 
information consists of three data bytes . The data can be obtained by 

three consecutive keyboard input operations. The qualifier word of each data 
byte returned to the application has the touch screen ID. Auto-repeat is 
performed. The three data bytes of sensing information are: 


05H - field touched report opcode 
dl - response string first byte 
d2 - response string second byte 

06H - field released report opcode 
dl - response string first byte 
d2 - response string second byte 


Touch fields can overlap. If they do, then the most recent definition tor 
a character cell takes precedent. 


ROW COLUMN OPERATIONS 


This type of touch operation returns the row and column position when a touch 
occurs. The row and column position are returned byte-by-byte using the 
keyboard input function of the operating system. Three data bytes are 
returned. The qualifier word returned with each byte of data has the touch 
screen ID. The data bytes for row/column operations are: 


03H - row column touch report opcode 
row - touched row number in binary 
col - touched column number in binary 

The data bytes for release report of row/ column are: 


04H - row column release report opcode 
row - touched row number in binary 
col - touched column nvmiber in binary 
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DEFINE TOUCH FIELD 

( 0 , 32 ) 

((STRING)) 

(LENGTH) 

(ATTRIBUTE, MODE) 


(ON-ENH,OFF-ENH) 
(CURSOR, BEEP) 


(LR-ROW,LR-COL) 

(UL-ROW,UL-COL) 


(ESC -zg) 


Function code 

Pointer to response string. Points to 2 words for keycode 
field the first word is the qualifier and the second word is 
the keycode. Points to 2 bytes for toggle or normal field, 
0-80 bytes for ASCII field. 

Response string length 

Touch ATTRIBUTE: 

1= ASCII field 
2= Keycode field 
3= Toggle field 
U= Normal field 

Reporting MODE: 

1= Report when touched 
2= Report when released 
3= Report both touch and release 


Enhancements of the field for on and off state for 
toggle field. Also enhancements of the field when touched 
and released for normal, ASCII, and keycode fields. 

CURSOR: 

0 = do not position cursor 

1 = position cursor on touch 


BEEP: 

0 = do not beep 

1 = beep on touch 


Row and 
field. 

column 

of 

the 

lower 

right corner 

of 

the 

touch 

Row and 
field. 

column 

of 

the 

upper 

left corner 

of 

the 

touch 
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DEFINE SOFTKEY FIELD (ESC - z s) 

This function defines one of the eight softkey label areas as a touch field. 
These fields when touched produce the sane response as if the corresponding 
function key is typed. The default is all softkey touch fields are on. 

(0,33) Function code 

(MODE, KEY) KEY (Softkey number) : 1-8 

MODE: 1 = on, 0 = off. 


DELETE TOUCH FIELD (ESC - z d) 

Deletes the touch field with upper left corner at <row> <col>. Nothing 

happens if there is no touch field there. The row and column are screen 
relative coordinates. 

(0,34) Function code 

(UL-R0W,UL-C0L) Row and column position of the field to be deleted. 

(0FFH,0FFH) deletes all fields. 


TOUCH SCREEN RESET (ESC - z j) 

Resets all fields to off. 

(0,35) Function code 


8-18 



AGIOS Function Call Reference 


SET TOUCH REPORTING MODES (ESC - z n) 


This function determines if, and how, touch is reported to your application by 
the HP 150 terminal. 


(0,36) 


Function code 


(, SCREEN-MODE) 


Touch Field and Row/Col sensing: 


0 - Disable reporting. 

1 - Enable sensing for row/ column position. Touch fields are 

inactive. 


2 - Enable sensing for touch fields only. Row/column sensing is 

inactive. 


3 - Enable sensing for both row/column and touch fields. 

Row/ column sensing occurs for areas not defined as touch 
fields . 

4 - Toggles touch screen on and off. 


10-14 - Same as 0-4, but causes escape sequence reports to 
be sent. This form is used ONLY by the system parser. 

(, TOUCH-MODE) Sense touch or touch-release: (used with Row/Col sensing 

only) 

1 - Report on Touch . 

2 - Report on Release 

3 - Report on both Touch and Release 
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KEYBOARD INTERCEPT 


Keyboard Intercept functions let you gain more control over the use of the 
keyboard. Each of the keyboard keys can be individually set to normal 
processing or one of the special processing modes. It should be noted that 
the key codes for [fl] through [fl2] are valid only when the application softkey 
labels are displayed on the screen with AGIOS function call (0,11). 

There is no explicit "get keycode and qualifier" function call. The standard 
operating system console input function returns the normal ASCII code and 
also keycodes. The qualifiers are also returned if keycode mode is on. 

The qualifier word is composed of the following bit values: 

Bit Value 

15-8 Input Device ID: 

0C0H = keyboard 
08 OH = touch screen 
000H = terminal internal 

7 Special key. If set, the data is a non-ASCII keycode. 

6 Reserved. 

5 Left extend char - set when down. 

U Right extend char - set when down. 

3 Control - set when down. 

2 Left shift - set when down. 

1 Right shift - set when down. 

0 Repeating key when set. 


To properly use the key intercept functions, the application program 
should first put the operating system’s console input device into raw mode. 
This will allow keycodes to be passed through without interpretation by the 
operating system. Keycode mode should then be turned on. Finally each of the 
keys on the keyboard can be set to the desired mode of operation. For more 
information see "Keyboard Interfacing" in Section 7 of this manual. 
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DEFINE KEY CHARACTERISTICS 


This function lets you alter characteristics of any of the special keys. 
Specifically, you can: 

v Process the key normally (Same as on HP 2623 terminal) 
v Intercept the key and pass a keycode to the application for processing 
v Ignore the key when it is pressed 

v Beep when the key is pressed in combination with the above characteristics 
(0,40) Function Code 

(CHARACTERISTICS) Key Characteristics 

Bit: Action: 0 beep 

1 intercept 

2 ignore 
3-15 reserved 

If bit 1 and 2 are both set, the key is treated as an 
intercept key. When both are zero, the key resumes normal 
functioning. 

(KEYCODE) Keycode from table on previous page. A value of OFEH will 

set all special keys to the specified characteristics. 


GET KEY CHARACTERISTICS 


This function 

(0,41) 

((BUFFER)) 


returns the characteristics of a key to the caller. 

Function Code 

Pointer to a buffer where the key’s characteristics will be 
returned . 


(KEYCODE) 


Keycode 
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PUT KEY 


This function lets you specify direct the terminal to process the keycode 
normally. Use this function when you wish to ’process’ a keypress which was read 
in when intercept mode was active. For normal ASCII keys, you would simply 
’echo’ the character in place of using this function. 


(0,42) 

(QUALIFIER) 


(KEYCODE) 


Function Code 
Qualifier 

Bit : Interpretation : 

15-8 = Input Device ID ( 0C0H = keyboard) 
7 = Special key. Must be set. 

6 = Reserved 

5 = Left extend char, set when down 

4 = Right extend char, set when down 

3 = Control, set when down 

2 = Left shift, set when down 

1 = Right shift, set when down 

0 = Not used 

Keycode 


KEYCODE ON/OFF 


This function turns the keycode mode of the console device on and off. If 
keycode mode is off, each key hit on the keyboard returns one byte of data when 
the console input device is read. If keycode mode is on, each key press 
returns four bytes of data. The first two bytes form a word of qualifiers 
and the next two bytes form a word of key data. See ’ Keycode Modes ’ in 
Section 7 for more detail. 


(0,43) Function Code 

MODE Keycode mode : 

1 = on 
0 = off 
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KEYCODE STATUS 

returns the on/off status of a key code. 

Function Code 

A pointer to a byte location where the key code on/off status 
is returned. 


This function 

(0 ,44) 
((BUFFER)) 


READ KEYPAD STATUS 


This function returns the status of whether the extended keypad is in 
numeric or graphics mode. 


(0,44) Function Code 

((BUFFER)) A pointer to a byte location where the keypad status is 

returned . 

When this function is complete, BUFFER contains 0 if numeric mode is set, and 1 
if graphics mode is set. 
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DISPLAY CONTROL (ESC * d) 


CLEAR GRAPHICS MEMORY (ESC * d a) 


This function clears graphics display memory to 0. The complete displayable 
graphics area of 512 x 390 dots are cleared. 


(it, 1) 


Function Code 


SET GRAPHICS MEMORY (ESC * d b) 


This function sets graphics display memory to 1. The complete displayable 
graphics area of 512 x 390 dots are set. 


(it, 2) 


Function Code 


TURN ON GRAPHICS DISPLAY (ESC * d c) 


This function turns on the graphics display. The data in graphics memory is 
not affected. 


(4, 3) 


Function Code 
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TURN OFF GRAPHICS DISPLAY (ESC * d d) 


This function turns off the graphics display. The data in graphics memory is 
not affected. 

( 4 , 4 ) Function Code 


TURN ON ALPHANUMERIC DISPLAY (ESC * d e) 


This function turns on the alphanumeric display and alphanumeric cursor. 
The data in alphanumeric memory is not affected. 


( 4 , 5 ) 


Function Code 


TURN OFF ALPHANUMERIC DISPLAY (ESC * d f) 


This function turns off the alphanumeric display. The data in alphanumeric 
memory is not affected. 


( 4 , 6 ) 


Function Code 


TURN ON GRAPHICS CURSOR (ESC * d k) 


This function turns on the graphics cursor. The data in graphics memory is 
not affected. 


( 4 , 7 ) 


Function Code 
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TURN OFF GRAPHICS CURSOR (ESC * d 1) 

This function turns off the graphics cursor. The data in graphics memory is 
not affected. 

(4, 8) Function Code 

TURN ON RUBBER BAND LINE (ESC * d m) 

This function turns on the rubber band line and graphics cursor. 

(4, 9) Function Code 

TURN OFF RUBBER BAND LINE (ESC * d n) 

This function turns off the rubber band line. 

(4,10) Function Code 


MOVE GRAPHICS CURSOR ABSOLUTE (ESC * d <x,y> o) 


This function moves the graphics cursor to the specified location. The 
move occurs even if the cursor is turned off. 


(4,11) Function Code 

(X -COORD) The X coordinate of the new cursor position expressed as an 

absolute number in the range of plus auid minus 16383 . 
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(Y-COORD) 


The Y coordinate of the new cursor position expressed as an 
absolute number in the range of plus and minus 16383 . 


MOVE GRAPHICS CURSOR INCREMENTAL (ESC * d <x,y> p) 


This function moves the graphics cursor to the specified location. The 
move occurs even if the cursor is turned off. 


(M2) 


Function Code 


(X-COORD) The X coordinates of the new cursor position expressed as a 

number that is relative to the current cursor position. Its 
range extends from -32768 to +32767. 

(Y-COORD) The Y coordinate of the new cursor position expressed as a 

number that is relative to the current cursor position. Its 
range extends from -32768 to +32767- 


TURN ON ALPHANUMERIC CURSOR (ESC * d q) 


This function turns on the alphanumeric cursor. The data in alphanumeric 
memory is not affected. 


(M3) 


Function Code 
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TURN OFF ALPHANUMERIC CURSOR (ESC * d r) 

This function turns off the alphanumeric cursor. The data in alphanumeric 
memory is not affected. 

(4.14) Function Code 

TURN ON GRAPHICS TEXT MODE (ESC * d s) 

This function turns on graphics text mode. Characters that normally go to 
the alphanumeric display will be drawn on the graphics display. 

(4.15) Function Code 

TURN OFF GRAPHICS TEXT MODE (ESC * d t) 

This function turns off graphics text mode. 

(4.16) Function Code 
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VECTOR DRAWING MODE ( ESC * m ) 


SELECT DRAWING MODE (ESC * m <mode> a) 


This function selects the vector drawing mode. 


(4,17) Function Code 

(MODE) Drawing Mode: 

0 = Graphics memory not changed 

1 = Clear mode 

2 = Set mode 

3 = Complement mode 

4 = Jam mode 


SELECT LINE TYPE (ESC * m <type> b) 


This function selects the vector line type. 


(4,18) Function Code 

(TYPE) Line Type: 

1 = 

2 = User defined line pattern 

3 = Current area fill pattern 

4= 

5 = 

6 = _r~L“ z tt ir~_ 

7 = 

8 = 

9 = - 

10 = 

11= Point plot 
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DEFINE LINE PATTERN AND SCALE (ESC * m <patternxscale> c) 


This function defines a user line pattern and scale. 


(M9) 

(.PATTERN) 

(SCALE) 


Function Code 

The line pattern expressed as an eight bit binary number. 
The line scale expressed as a binary number from 1 to 16. 


DEFINE AREA FILL PATTERN (ESC * m <pattern> d) 


This function defines a user area fill pattern of 8 by 8 screen dots. 


(L,20) 


Function Code 


(.DATA R0W1) 
(.DATA R0W2) 
(.DATA R0W3) 
(.DATA R0W2) 
( .DATA R0W4) 
(.DATA R0W5) 
(.DATA R0W6) 
( .DATA R0W7) 
(.DATA R0W8) 


You specify all eight rows of the 8 by 8 fill pattern. Each 
DATA-ROW is an eight-bit byte which defines a particular row 
of the pattern. 
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FILL RECTANGULAR AREA, ABSOLUTE (ESC * m <xl,yl,x2,y2> e) 


This function fills a rectangular area with the selected line or area 
fill pattern. The rectangular region is defined by specifying the lower 
left and upper right coordinates. 


(4,21) Function Code 

(LWR LEFT X- COORD) Each coordinate 
(LWR LEFT Y- COORD) 

(UPR RIGHT X-COORD) 

(UPR RIGHT Y-COORD) 


is in the range of -16384 to + 16383 . 


FILL RECTANGULAR AREA, RELOCATABLE (ESC * m <xl,yl,x2,y2> f) 


This function fills a rectangular area with the selected line or area 
fill pattern. The rectangular region is defined by specifying the lower 
left and upper right coordinates. 


(4,22) Function Code 

(LWR LEFT X-COORD) Each value is 
(LWR LEFT Y-COORD) 

(UPR RIGHT X-COORD) 

(UPR RIGHT Y-COORD) 


in the range from -32768 to +32767* 


SELECT POLYGONAL FILL PATTERN (ESC * m <pattern> g) 


This function selects a pattern for polygonal and rectangular area 
fill. 
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(4,23) Function Code 

(PATTERN) Area Fill Pattern: 

1 = Solid fill pattern 

2 = User-defined fill pattern 
3-10 = Pre-def ined fill pattern 


SELECT BOUNDARY PEN (ESC * m <pen> h) 

This function selects the pen to be used to draw the boundary of a filled 
polygon. The actual value is not significant in a black and white system. 
This function turns on boundary drawing with a solid line pattern. The 
drawing of each edge of the boundary can be individually controlled. 

(4,24) Function Code 

(PEN) Boundary Pen Number 


NO POLYGON BOUNDARY (ESC * m h) 

This function turns off drawing of boundary around a polygon. 
(4,25) Function Code 
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SET RELOCATABLE ORIGIN (ESC * m <x,y> j) 

This function sets the relocatable origin to the specified absolute 
location. 

(4,26) Funct ion Code 

(X-COORD) The X coordinate is the new relocatable origin expressed as 

an absolute number in the range of -16384 to +16383. 

(Y-COORD) The Y coordinate is the new relocatable origin expressed as 

an absolute number in the range of -16384 to +16383. 


SET RELOCATABLE ORIGIN TO PEN POSITION (ESC * m k) 

This function sets the relocatable origin to the current pen position. 

(4,27) Function Code 


SET RELOCATABLE ORIGIN TO CURSOR POSITION (ESC * m 1) 

This function sets the relocatable origin to the current cursor position. 

(4,28) Function Code 
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GRAPHICS TEXT (ESC *) 


The HP 150 offers a comprehensive graphics character set in read-only memory 
(ROM). This standard character set is used by all graphics text operations. 
However, you do have the ability to create custom characters of your own design 
and to use these singly or to replace the entire built-in character set. 


SET GRAPHICS TEXT SIZE (ESC * m <size> m) 


This function sets the graphics text size. The vector lists that define the 
current character set are scaled using this text size. 


( 14,29) Function Code 

(X-SCALE) The X coordinate scale factor for text characters. The 

format is a 1 6 bit number with the radix point between bits 
7 and 8: 

Bits 1-8 = integer 
Bits 9-16 = fraction 

(Y-SCALE) The Y coordinate scale factor for text characters. Hie 

format is a 16 bit number with the radix point between bits 
7 and 8: 

Bits 1-8 - integer 
Bits 9 -I 0 = fraction 


SET GRAPHICS TEXT ORIENTATION (ESC * m <orientation> n) 


This function selects the graphics text orientation. This also changes the 
direction of line feed, carriage return, and backspace. The desired 
orientation is specified by a number defined as: 
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(4,30) Function Code 

(ORIENTATION) Graphics Text Orientation: 

1 = Normal 

2 = Rotate 90 degrees counterclockwise 

3 = Rotate 180 degrees counterclockwise 

4 = Rotate 270 degrees counterclockwise 


TURN ON TEXT SLANT (ESC * m o) 


This function turns on the 26.37 degree slant of graphics text 
characters . 


(4,31) Function Code 


TURN OFF TEXT SLANT (ESC * m p) 


This function turns off 26*57 degrees slant of graphics text characters. 


(4,32) Function Code 
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SET GRAPHICS TEXT ORIGIN (ESC * m <0-9> q) 

This function sets the graphics text origin to one of twelve positions of text 
justification. The positions are shown in this figure: 

3 6 

I 
I 
I 

1 

2 5 

I 

Base line -> 0 10 

I 
I 

1 4 

(4,33) Function Code 

(ORIGIN) Graphics Text Origin: 

A number from 0 to 11. 


GRAPHICS TEXT LABEL (ESC * 1 <text>) 

This function outputs a string of graphics characters. 

(4,34) Function Code 

( (TEXT) ) Segment and offset address of a string of characters. The 

string must be terminated by CR, LF, CR LF, or LF CR. 


9 


8 

I 

11 

I 

I 

-7 
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DEFINE USER CHARACTER SET 


This function lets you re-define the entire graphics character set. All 
subsequent graphics text operations will use this character set. This includes 
text size, orientation, slant, and justification. 

(4,35) Function Code 

((TABLE)) Segment and offset address of the table that points to the 

vector lists of characters. 


SELECT DEFAULT CHARACTER SET 


This function sets the character set to the default set maintained by the 
system. The cell size is 7 x 10. 


(4,36) Function Code 


OUTPUT SINGLE TEXT CHARACTER 


This function outputs a single graphics character defined by a vector list. All 
current graphics text operations such as size and orientation apply. 

(4,37) Function Code 

( (CHARACTER) ) Segment and offset address of the vector list of a single 

character . 
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SET GRAPHICS DEFAULT (ESC * m r) 


This function sets the graphics parameters to their default values. 
(h,38) Function Code 


The defaults affected by this call are: 

Pen down 
Line type 1 

User-defined line pattern solid 

User-defined area fill pattern solid 

Boundary pen off 

Drawing mode set 

Relocatable origin 0,0 

Text size 1 

Text origin 1 

Text slant off 

Text orientation 1 

Graphics text off 

Graphics display on 

Alphanumeric display on 

Graphics cursor off 

Alphanumeric cursor on 

Rubber band line off 

Graphics cursor position 0,0 
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SET PICTURE DEFINITION DEFAULTS (ESC * m 1 r) 


This function sets the picture definition parameters to their default values. 
(U,72) Function Code 

(RESET LEVEL) The level of graphics reset. On the HP 150 the value *1’ is 

the only supported level. 

The picture defaults are: 

Pen down 
Line type 1 

User-defined line pattern solid 

User-defined area fill pattern solid 

Boundary pen off 

Drawing mode set 

Text size 1 

Text origin 1 

Text slant off 

Text orientation 1 

Graphics text off 


GRAPHICS HARD RESET (ESC * w r) 


Sets the graphics parameters to their power on state. 


(U,73) 


Function Code 
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GRAPHICS PLOTTING ( ESC * p ) 

LIFT PEN (ESC* pa) 

This function lifts the pen. 

(4,39) Function Code 

VECTOR MOVE (ESC * p a <x,y>) 

This function lifts the pen and moves the pen to the new coordinate position. 
The pen is lowered at the end of the operation. 

There are three ways to specify the new coordinate position: 


(4,40) 

Function Code 



(X-COORD) 

(Y-COORD) 

The X and Y numbers give an absolute coordinate position in 
the range from -16384 to + 16383 . 

(4,41) 

Function Code 



(X-COORD) 

(Y-COORD) 

The X and Y numbers give an incremental 
in the range from -32768 to + 32767 . 

coordinate 

position 

(4,42) 

Function Code 



(X-coord) 

(Y-coord) 

The X and Y numbers give a relocatable 
in the range from -32768 to +32767- 

coordinate 

position 
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LOWER PEN (ESC * p b) 


This function lowers the pen. 


(4,43) Function Code 


VECTOR DRAW (ESC * p b <x,y>) 


This function lowers the pen and draws a vector to the new coordinate position. 
The pen is lowered at the end of the operation. 

There are three ways to specify the new vector coordinates: 

(4,44) Function Code 

(X-COORD) The X and Y numbers give the absolute coordinates of the 

(Y-COORD) vector position. They are in the range from -16384 to 

+16383. 


(4,45) Function Code 

(X-COORD) The X and Y numbers give the incremental coordinates of the 

(Y-COORD) vector position. They are in the range from -32768 to 

+32767. 


(4,46) Function Code 

(X-COORD) The X and Y numbers give the relocatable coordinates of the 

(Y-COORD) vector position. They are in the range from -32768 to 

+32767. 
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PLOTlTO CURSOR POSITION (ESC * p c) 


This function moves the pen from its current position to the current cursor 
position if the pen is up. A draw is performed from the current pen 
position to the current cursor position if the pen is down. 


(4,47) Function Code 


POINT PLOT (ESC * p d) 

This function draws a dot at the current pen position and then lifts the pen. 

(4.48) Function Code 

SET RELOCATABLE ORIGIN TO PEN POSITION (ESC * p e) 

This function sets the relocatable origin to the current pen position. 

(4.49) Function Code 
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START POLYGONAL AREA FILL (ESC * p s) 

This function starts polygonal area fill. The boundary pen is lowered with this 
function. 

(4.50) Function Code 

TERMINATE POLYGONAL AREA FILL (ESC * p t) 

This function terminates the polygon definition and fills the polygon. 

(4.51) Function Code 

POLYGON MOVE 

This function closes the polygon defined up to this point and moves the pen 
to the new coordinate position to start a new polygon. 

There are three ways to specify the new coordinate position: 

(4.52) Function Code 

(X-COORD) The X and Y numbers give the absolute coordinates of the new 

(Y-COORD) position. They are in the range from -16384 to + 16383 . 

(4.53) Function Code 

(X-COORD) The X and Y numbers give the incremental coordinates of the 

(Y-COORD) new position. They are in the range from -32767 to + 32767 . 

(4.54) Function Code 


8-43 



AGIOS Function Call Reference 

(X-COORD) The X and T numbers give the relocatable coordinates of the 

(Y-COORD) new position. They are in the range from -32768 to +32767. 

POLYGON DRAW 

This function defines the edge of a polygon from the current pen position to 
the new coordinate position. 

There are three ways that you can specify the new coordinate position: 


(4,55) 

Function Code 



(X-COORD) 

(Y-COORD) 

The X and Y numbers 
position. They are 

give the absolute coordinates of the 
in the range from -16384 to + 16383 . 

new 

(4,56) 

Function Code 



1 1 
o o 

11 

The X and Y numbers 
new position. They 

give the incremental coordinates of the 
are in the range from -32768 to + 32767 . 

(4,57) 

Function Code 



(X-COORD) 

(Y-COORD) 

The X and Y numbers 
new position. They 

give the relocatable coordinates of 
are the range from -32768 to + 32767 . 

the 


LIFT BOUNDARY PEN (ESC * p u) 


This function lifts the polygon boundary pen. Undrawn edges of the 
polygon are not drawn. This remains in effect until the boundary pen is 
lowered . 


(4,58) Function Code 
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LOWER BOUNDARY PEN (ESC * p v) 


This function lowers the polygon boundary pen. If a boundary pen has 
specified, undrawn edges of the polygon are drawn with a solid 
pattern. This remains in effect until the boundary pen is lifted. 


been 

line 


(U.59) 


Function Code 
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GRAPHICS STATUS ( ESC * s ) 

READ DEVICE ID (ESC * s 1) 

This function returns the device id of the HP 150. 

(4. 60 ) Function Code 

((BUFFER)) Segment and offset address of the buffer to be used for 

returned device data. 

When this function is complete, BUFFER contains an ASCII string that identifies 
the device. 

READ PEN POSITION (ESC * s 2) 

This function returns the current position and the state of the pen. 

(4. 61) Function Code 

((BUFFER)) Segment and offset address of the buffer to be used for 

returned pen status data. 

When this function is complete, BUFFER contains: 

(X-COORD) The binary X and Y coordinates of the current pen position 

(Y-COORD) 

(STATE) 0 = pen lifted, 1 = pen lowered 
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READ CURSOR POSITION (ESC * s 3) 


This function returns the current position of the cursor. 


(4,62) Function Code 

( (BUFFER) ) Segment and offset address of the buffer to be used for 

the returned cursor data. 


When this function is complete, BUFFER contains: 

(X-COORD) The X and Y coordinates of current cursor position. 

(Y-COORD) 


READ CURSOR POSITION, WAIT FOR KEY (ESC ♦ s 4) 


This function returns the current position of the cursor, but lets the 
user move it on the display first. The user can type any ASCII key or the 
SELECT key on the keyboard to move the cursor. As soon as one of these 
characters is typed, the cursor coordinates are returned to the program. 


(4,63) Function Code 

((BUFFER)) Segment and offset address of the buffer to be used for 

returned cursor position. 

When this function is complete, BUFFER contains: 

(X-COORD) The X and Y coordinates of current cursor position. 

(Y-COORD) 

(CODE) The character code of the key that was typed. 
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READ DISPLAY SIZE (ESC * s 5) 


This function returns the number of displayable units and also the number of 
units in millimeters. 

(4,64) Function Code 

((BUFFER)) Segment and offset address of the buffer to be used for 

the returned displayable size and unit data. 


When this function is complete, BUFFER contains: 

(X-LWR-LEFT) The X and Y coordinates of the maximum display size. 

(Y-LWR-LEFT) 

(X-UPR-RIGHT) 

(Y-UFR-RIGHT) 

(X-MM) The X and Y dimensions in dots / millimeters. 

(Y-MM) 


READ GRAPHICS SETTINGS (ESC * s 6) 


This function returns information about the current graphics settings in 
effect . 

(4,65) Function Code 

((BUFFER)) Segment and offset address of the buffer to be used for 

returned graphics settings. 

When this function is complete, BUFFER contains the settings in consecutive 
words : 

(CLEAR DISPLAY) 

(NUMBER OF PENS) 

(RESERVED) 

(RESERVED) 

(AREA SHADING) 

(RESERVED) 

(RESERVED) 

(DYNAMIC MODIFICATION) 

(GRAPHICS CHARACTER SIZE) 

(GRAPHICS CHARACTER ANGLES) 
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(GRAPHICS CHARACTER SLANT) 
(DOT-DASH LINE PATTERN) 
(RESERVED) 

(RESERVED) 

(RESERVED) 

(RESERVED) 


READ GRAPHICS TEXT STATUS (ESC * s 7) 


This function returns the current attributes of graphics text. 


(4,66) Function Code 

((BUFFER)) Segment and offset address of the buffer to be used for 

the returned graphics attributes. 

When this function is complete, BUFFER contains: 

(X SIZE) The character cell size. 

(Y SIZE) 

(ORIGIN) The text origin. 

(ANGLE) The text orientation. 

(SLANT) The character slant. 


READ ZOOM STATUS (ESC * s 8) 


This function returns the terminal’s zoom setting. 


(4,67) Function Code 

((BUFFER)) Segment and offset address of the buffer to be used for 

the returned zoom setting. 
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When this function is complete, BUFFER contains: 

(ZOOM SIZE) 1-16 (the HP 150 always returns 1). 

(ZOOM ON/OFF) 0 = off, 1 = on (the HP 150 always returns 0). 


READ RELOCATABLE ORIGIN (ESC * s 9) 


This function returns the current relocatable origin. 


( 4 , 68 ) Function Code 

((BUFFER)) Segment and offset address of the buffer to be used for 

the returned origin. 

When this function is complete, BUFFER contains: 

(X-COORD) The X and Y coordinates of the current relocatable origin. 

(Y-COORD) 


READ RESET STATUS (ESC * s 10) 


This function returns information on whether the terminal has executed a 
full reset since the last time reset status was checked. 


(4,69) Function Code 

( (BUFFER) ) Segment and offset address of the buffer to be used for 

the returned reset status. 


When this function is complete, BUFFER contains: 

(RESET STATUS) 

(RESERVED) 

(RESERVED) 

(RESERVED) 

(RESERVED) 

(RESERVED) 

(RESERVED) 
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(RESERVED) 


READ AREA SHADING (ESC * s 11) 

This function returns information on the area shading capability of the 
terminal. 

(4,70) Function Code 

((BUFFER)) Segment and offset address of the buffer to be used for 

the returned shading data. 

When this function is complete, BUFFER contains: 

(CAPABILITIES) The area shading capabilities. 

(WIDTH) The area shading pattern size. 

(HEIGHT) 


READ DYNAMICS (ESC * s 12) 

This function returns information on the terminal’s dynamic graphics 
capabilities. 

(4,71) Function Code 

((BUFFER)) Segment and offset address of the buffer to be used for 

the returned dynamic graphics data. 

When this function is complete, BUFFER contains: 

( SELECTIVE -ERASE -CAPABILITIES ) 

(COMPLEMENT-CAPABILITIES) 
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READ EXTENDED SCREEN DIMENSIONS 


This function provides information about the alpha and graphics screen size plus 
the relationship between the two. 

(0,7**) Function Code 

((BUFFER)) Segment and offset address of the buffer to be used for the 

returned screen size data. 

When this function is complete, BUFFER contains: 

(X-PIXELS) 512 graphics display size in pixels. 

(Y-PIXELS) 390 

(ROWS) 27 alpha display size. 

(COLUMNS) 80 

(X-MM) 160 graphics display size in mm. 

(Y-MM) 120 

(ROW-MM) 1^0 alpha display size in mm. 

(COL -MM) 116 

(DELTA-X) 10 graphics origin minus alpha origin in mm. 

(DELTA- Y) L 
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Figure A- 2. Keyboard PCA 
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Figure A-6. Keyboard PCA Port 
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Figure A- 7- Video Alpha RAM Subsystem 
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Figure A-8. Video Alpha Display Subsystem 
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Figure A-9 . Video Graphics Display Subsystem 
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Figure A-10. Thermal Printer Interface (Part of Front Plane PCA) 
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Figure A-13 • Sweep PCA 
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